Puntos de acceso

Lista tus aplicaciones

Las aplicaciones que puede ver tu clave, las más recientes primero, con búsqueda y páginas.

GEThttps://www.setherion.com/api/v1/projects

Plan: 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

bash
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:

bash
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:

bash
curl "https://www.setherion.com/api/v1/projects?offset=100" \
  -H "Authorization: Bearer $SETHERION_API_KEY"
ParámetroSignificado
qOpcional. 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.
offsetOpcional. 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:

json
{
  "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.)

CampoTipoSignificado
totalnúmeroCuántas aplicaciones coinciden, incluidas las que no están en esta página.
truncatedbooleanotrue cuando hay más aplicaciones después de esta página.
offsetnúmeroDónde empieza esta página.
nextOffsetnúmero o nullDónde empieza la página siguiente, o null en la última.
idcadenaEl id de la aplicación. Úsalo para editar o publicar la aplicación.
namecadenaEl nombre de la aplicación, como en tu panel de control.
descriptioncadena o nullLa descripción de la aplicación, si la tiene.
urlcadena o nullDónde está la aplicación online, o null si no está publicada.
updatedAtcadenaCuá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

js
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

EstadoCuándo
400q tiene más de 100 caracteres, o offset no es un número entero.
401Falta la clave, es incorrecta o está revocada.
500No se pudo leer la lista. Inténtalo de nuevo.
Las frases exactas
Estadoerror
400q is at most 100 characters.
400offset is a whole number, 0 or more.
500Could not list your apps.

¿Te ha sido útil esta página?

Únete a la comunidad

Preguntas, ideas y lo que otros están construyendo.