Listează aplicațiile tale

Returnează aplicațiile din panoul tău de control: ale tale, cele din spațiile de lucru în care ești și cele partajate cu tine, cele schimbate cel mai recent primele. Aplicațiile șterse nu sunt incluse. Orice rol e de ajuns, inclusiv viewer.

Aplicațiile vin câte 100. total spune câte se potrivesc, iar cât timp mai urmează altele, truncated este true și nextOffset spune de unde începe pagina următoare. Ca să găsești o singură aplicație fără să le citești pe toate, caută cu q.

Listarea este gratuită și nu consumă credite.

Cererea

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Ca să cauți, adaugă q. Se potrivește cu cuvintele oriunde în numele sau descrierea unei aplicații, indiferent de litere mari sau mici:

curl "https://www.setherion.com/api/v1/projects?q=coffee" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Pentru pagina următoare, adaugă offset cu nextOffset din răspunsul de dinainte:

curl "https://www.setherion.com/api/v1/projects?offset=100" \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Ordinea este după ultima schimbare, iar id-ul aplicației desparte egalitățile, așa că două aplicații schimbate în aceeași clipă nu își schimbă niciodată locul de la o pagină la alta. O aplicație schimbată între două cereri de pagină urcă în fruntea listei, așa că citește paginile dintr-o singură trecere.

Răspunsul

Prima pagină a unui cont cu mai mult de 100 de aplicații:

{
  "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"
    }
  ]
}

(Lista projects conține până la 100 de intrări. Sunt arătate două.)

O pagină dincolo de sfârșit nu este o eroare: răspunde cu ok: true și cu o listă projects goală.

Citește toate paginile

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
}

Erori