hosting

GET /v1/site-blueprints

List your site blueprints.

Alle hosting Endpunkte

Authentifizierung

Senden Sie einen API-Schlüssel als Bearer-Token. Der Schlüssel muss über die Berechtigung sites.view verfügen; ein Schlüssel ohne diese wird mit 403 statt 404 abgelehnt.

Dieser Endpunkt erfordert keine Organisations-ID. Ihr Schlüssel identifiziert bereits die zugehörige Organisation, und die Antwort ist entsprechend eingeschränkt.

Ausprobieren

Ersetzen Sie alles in spitzen Klammern durch Ihre eigenen Werte und den Platzhalter für den Schlüssel durch einen Schlüssel aus Ihrem Dashboard.

curl -X GET https://api.zinndigital.com/v1/site-blueprints \
  -H "Authorization: Bearer zdk_live_…"

Angemeldet? Die API-Konsole in Ihrem Dashboard trägt automatisch Ihre echte Organisations-ID sowie Ihren eigenen Schlüssel ein und führt die Anfrage gegen die Live-API aus, sodass Sie die tatsächliche Antwort sehen können. Öffnen Sie diesen Endpunkt in der API-Konsole

Details

The management screen's data. A cheap database read, polled while a capture is in flight, so it never calls object storage — `has_screenshot` reports whether a picture exists and each tile asks for its own short-lived URL. Filter by `stack_type` to get exactly the blueprints that can be deployed onto a site of that stack; that is the same field the engine refuses a mismatch on, so a picker built on it cannot drift from the guard. Requires `sites.view`.

Parameter

NameTypErforderlichWas es ist
stack_type (query)StackTypeNeinOnly blueprints captured from a site of this stack. The compatibility axis — a WordPress blueprint can only be deployed onto WordPress.
cursor (query)stringNeinOpaque cursor from a previous page's `page.next_cursor`.
limit (query)integerNeinMaximum items to return (page size).
ordering (query)stringNeinSort key, optionally `-`-prefixed for descending. One of `created` or `name`; defaults to `-created` (newest first). An unrecognised key is a `422`, never a silent fall back to…

Antwort

NameTypErforderlichWas es ist
dataSiteBlueprint[]Ja
pagePageMetaJa

Fehler, die dieser Endpunkt zurückgeben kann

401 · 403 · 429