hosting
GET /v1/sites/{siteId}/deployments/{deploymentId}/build-log
The hosting provider's own build log for one deploy.
Autentizace
Zašlete API klíč jako nosný token (bearer token). Klíč musí mít oprávnění sites.view; klíč bez něj je odmítnut s kódem 403, nikoli 404.
Tento koncový bod nevyžaduje žádné ID organizace. Váš klíč již identifikuje organizaci, ke které patří, a odpověď je na ni omezena.
Vyzvednout
Nahraďte cokoli v závorkách vlastními hodnotami a zástupný symbol klíče klíčem z vašeho řídicího panelu.
curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/deployments/{deploymentId}/build-log \
-H "Authorization: Bearer zdk_live_…"Přihlášeni? Konzole API ve vašem dashboardu automaticky doplní vaše skutečné ID organizace i váš vlastní klíč a odešle požadavek na živé API, abyste viděli reálnou odpověď. Otevřete tento koncový bod v konzoli API
Podrobnosti
Distinct from the log on GET /deployments/{deploymentId}, which is the platform's own five steps and is the same five whether a build succeeded or failed. When a build fails this is the only text that says WHY. Tail it with after while complete is false; after is a line offset so a live tail is incremental rather than re-fetching a growing log. A provider that publishes no build log, or a deploy that rebuilt nothing, returns UNPROCESSABLE_ENTITY with the reason — never an empty log, which would read as "your build printed nothing". Requires sites.view.
Parametry
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
siteId (path) | Uuid | Ano | Site ID (UUIDv7). |
deploymentId (path) | Uuid | Ano | Deployment ID (UUIDv7). |
after (query) | integer | Ne | Skip this many lines — the count already rendered. |
Odpověď
| Název | Typ | Požadováno | Co to je |
|---|---|---|---|
lines | BuildLogLine[] | Ano | — |
complete | boolean | Ano | Whether the build has finished producing lines. Read from the deployment's terminal state, never from "no new lines this time" — a stalled build and a finished one produce the… |
total | integer | Ano | Lines the provider says exist, or -1 where it publishes no total. Never 0 for unknown, which would read as an empty log. |
Chyby, které může tento koncový bod vrátit
401 · 403 · 404 · 422 · 429