Puntos de acceso
Lista tus aplicaciones
Las aplicaciones que puede ver tu clave, las más recientes primero, con búsqueda y páginas.
https://www.setherion.com/api/v1/projectsPlan: Cualquier plan
Devuelve las aplicaciones de tu panel de control: las tuyas, las de los espacios de trabajo a los que perteneces y las que han compartido contigo, las modificadas más recientemente primero. Las aplicaciones eliminadas no se incluyen. Basta con cualquier rol, incluido viewer.
Las aplicaciones llegan de 100 en 100. total indica cuántas coinciden y, mientras haya más, truncated es true y nextOffset indica dónde empieza la página siguiente. Para encontrar una sola aplicación sin leerlas todas, busca con q.
Listar es gratis y no consume créditos.
Solicitud
curl https://www.setherion.com/api/v1/projects \
-H "Authorization: Bearer $SETHERION_API_KEY"Para buscar, añade q. Coincide con las palabras en cualquier parte del nombre o la descripción de una aplicación, sin distinguir mayúsculas de minúsculas:
curl "https://www.setherion.com/api/v1/projects?q=coffee" \
-H "Authorization: Bearer $SETHERION_API_KEY"Para la página siguiente, añade offset con el nextOffset de la respuesta anterior:
curl "https://www.setherion.com/api/v1/projects?offset=100" \
-H "Authorization: Bearer $SETHERION_API_KEY"| Parámetro | Significado |
|---|---|
q | Opcional. Texto que buscar en el nombre o la descripción de la aplicación. Los espacios alrededor se ignoran. Hasta 100 caracteres. Un % o un _ dentro del texto se toma literalmente, así que buscar 50% no coincide con todas las aplicaciones. |
offset | Opcional. Dónde empieza la página, contando desde 0: el nextOffset de la respuesta anterior. Un número entero de hasta seis dígitos. |
El orden es por último cambio, y el id de la aplicación desempata, de modo que dos aplicaciones modificadas en el mismo instante nunca se intercambian de sitio entre una página y la siguiente. Una aplicación modificada entre dos solicitudes de página pasa a la parte superior de la lista, así que lee las páginas de una sola vez.
Respuesta
La primera página de una cuenta con más de 100 aplicaciones:
{
"ok": true,
"total": 142,
"truncated": true,
"offset": 0,
"nextOffset": 100,
"projects": [
{
"id": "7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14",
"name": "Coffee shop",
"description": "Website for a coffee shop in Leeds",
"url": "https://coffee-shop.setherion.app",
"updatedAt": "2026-09-19T10:42:07.000Z"
},
{
"id": "0e9d3b6a-41c2-4d7f-b8a5-6f1c2a9d4e30",
"name": "Booking tool",
"description": null,
"url": null,
"updatedAt": "2026-09-18T16:03:51.000Z"
}
]
}(La lista projects contiene hasta 100 entradas. Aquí se muestran dos.)
| Campo | Tipo | Significado |
|---|---|---|
total | número | Cuántas aplicaciones coinciden, incluidas las que no están en esta página. |
truncated | booleano | true cuando hay más aplicaciones después de esta página. |
offset | número | Dónde empieza esta página. |
nextOffset | número o null | Dónde empieza la página siguiente, o null en la última. |
id | cadena | El id de la aplicación. Úsalo para editar o publicar la aplicación. |
name | cadena | El nombre de la aplicación, como en tu panel de control. |
description | cadena o null | La descripción de la aplicación, si la tiene. |
url | cadena o null | Dónde está la aplicación online, o null si no está publicada. |
updatedAt | cadena | Cuándo cambió la aplicación por última vez, en ISO 8601. |
Una página más allá del final no es un error: responde ok: true con una lista projects vacía.
Lee todas las páginas
const base = 'https://www.setherion.com/api/v1/projects'
const headers = { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` }
let offset = 0
const all = []
while (offset !== null) {
const page = await fetch(`${base}?offset=${offset}`, { headers }).then(r => r.json())
if (!page.ok) throw new Error(page.error)
all.push(...page.projects)
offset = page.nextOffset
}Errores
| Estado | Cuándo |
|---|---|
400 | q tiene más de 100 caracteres, o offset no es un número entero. |
401 | Falta la clave, es incorrecta o está revocada. |
500 | No se pudo leer la lista. Inténtalo de nuevo. |
Las frases exactas
| Estado | error |
|---|---|
400 | q is at most 100 characters. |
400 | offset is a whole number, 0 or more. |
500 | Could not list your apps. |
¿Te ha sido útil esta página?
