Endpunkte

Ihre Apps auflisten

Die Apps, die Ihr Schlüssel sehen kann, die neuesten zuerst, mit Suche und Seiten.

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

Tarif: Jeder Tarif

Gibt die Apps auf Ihrem Dashboard zurück: Ihre eigenen, die in Arbeitsbereichen, denen Sie angehören, und die mit Ihnen geteilten, die zuletzt geänderten zuerst. Gelöschte Apps sind nicht enthalten. Jede Rolle genügt, auch Viewer.

Die Apps kommen jeweils zu 100. total sagt, wie viele passen, und solange weitere folgen, ist truncated gleich true, und nextOffset sagt, wo die nächste Seite beginnt. Um eine einzelne App zu finden, ohne alle zu lesen, suchen Sie mit q.

Das Auflisten ist kostenlos und verbraucht keine Credits.

Anfrage

bash

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

Um zu suchen, fügen Sie q hinzu. Es findet die Wörter an beliebiger Stelle im Namen oder in der Beschreibung einer App, unabhängig von Groß- und Kleinschreibung:

bash

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

Für die nächste Seite fügen Sie offset mit dem nextOffset der vorherigen Antwort hinzu:

bash

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

Parameter	Bedeutung
`q`	Optional. Text, der im Namen oder in der Beschreibung der App gefunden werden soll. Leerzeichen davor und danach werden ignoriert. Bis zu 100 Zeichen. Ein `%` oder `_` darin wird wörtlich genommen, sodass die Suche nach `50%` nicht auf jede App passt.
`offset`	Optional. Wo die Seite beginnt, ab 0 gezählt: das `nextOffset` der vorherigen Antwort. Eine ganze Zahl mit bis zu sechs Ziffern.

Die Reihenfolge richtet sich nach der letzten Änderung, wobei die ID der App bei Gleichstand entscheidet, sodass zwei im selben Augenblick geänderte Apps zwischen einer Seite und der nächsten nie die Plätze tauschen. Eine App, die zwischen zwei Seitenanfragen geändert wird, rückt an den Anfang der Liste. Lesen Sie die Seiten daher in einem Durchgang.

Antwort

Die erste Seite eines Kontos mit mehr als 100 Apps:

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

(Das Array projects enthält bis zu 100 Einträge. Zwei werden gezeigt.)

Feld	Typ	Bedeutung
`total`	number	Wie viele Apps passen, einschließlich derer, die nicht auf dieser Seite stehen.
`truncated`	boolean	`true`, wenn nach dieser Seite weitere Apps folgen.
`offset`	number	Wo diese Seite beginnt.
`nextOffset`	number or null	Wo die nächste Seite beginnt, oder `null` auf der letzten.
`id`	string	Die ID der App. Damit ändern oder veröffentlichen Sie die App.
`name`	string	Der Name der App, wie auf Ihrem Dashboard.
`description`	string or null	Die Beschreibung der App, falls sie eine hat.
`url`	string or null	Wo die App online ist, oder `null`, wenn sie nicht veröffentlicht ist.
`updatedAt`	string	Wann die App zuletzt geändert wurde, im Format ISO 8601.

Eine Seite hinter dem Ende ist kein Fehler: Sie antwortet mit ok: true und einer leeren Liste projects.

Alle Seiten lesen

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
}

Fehler

Status	Wann
`400`	`q` ist länger als 100 Zeichen, oder `offset` ist keine ganze Zahl.
`401`	Der Schlüssel fehlt, ist falsch oder wurde widerrufen.
`500`	Die Liste konnte nicht gelesen werden. Versuchen Sie es erneut.

Die genauen Sätze

Status	`error`
`400`	`q is at most 100 characters.`
`400`	`offset is a whole number, 0 or more.`
`500`	`Could not list your apps.`

War diese Seite hilfreich?

Zurück

Authentifizierung

Weiter

Eine App ändern

Der Community beitreten

Fragen, Ideen und was andere erstellen.