hosting

GET `/v1/sites/{siteId}/deployments/{deploymentId}`

One deploy, with its build log.

تصدیق‌هویت

یو API کی د بیئرر ټوکن (bearer token) په توګه ولیکئ. کی باید د sites.view اجازه ولري؛ له دې اجازې پرته کی د 404 پرځای د 403 په واسطه رد کیږي.

دا پای نقطه د سازمان هېڅ آی ډي نه اخلي. ستاسو کیلي مخکې تر مخکې هغه سازمان په ګوته کوي چې پورې اړه لري، او ځواب ورته محدود دی.

هڅه وکړئ

د انګلیسي په زاوي پنسونو کې هرڅه د خپلو ارزښتونو سره بدل کړئ، او د کلي ځای لرونکی ستاسو د ډشبورډ د کلي سره.

curl -X GET https://api.zinndigital.com/v1/sites/{siteId}/deployments/{deploymentId} \
  -H "Authorization: Bearer zdk_live_…"

ننوتي یاست؟ ستاسو په ډشبورډ کې د API کنسول ستاسو د اصلي سازمان ID او ستاسو خپله کیلي ډکوي، او غوښتنه د ژوندی API په وړاندې پرمخ وړي ترڅو تاسو وکولی شئ اصلي ځواب وګورئ. دا پای ټکی (endpoint) د API په کنسول کې پرانیزئ

تفصیلات

The log is written line by line as the build runs rather than at the end, so it is readable while a deploy is in flight and present on one that hangs. Requires sites.view.

پارامترونه

نوم	ډول	اړین	دا څه شی دی
`siteId (path)`	`Uuid`	هو	Site ID (UUIDv7).
`deploymentId (path)`	`Uuid`	هو	Deployment ID (UUIDv7).

ځواب

نوم	ډول	اړین	دا څه شی دی
`id`	`Uuid`	هو	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`site_id`	`Uuid`	هو	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`target`	`DeployTarget`	هو	Where the site is published from. `fleet` is our own managed fleet; the rest are managed edge hosts, deployed to from a pooled account of ours or the customer's own connected one.…
`status`	`DeployStatus`	هو	`idle` means the site has never been deployed. It is reported, never stored — a stored idle would be a second way to say "no deployments" that could contradict the first.
`trigger`	`DeployTrigger`	هو	What caused the deploy. Stored because `requested_by` cannot answer it for a push — the actor there is a webhook delivery, not a person.
`repo`	`object`	هو	—
`branch`	`object`	هو	—
`commit`	`object`	هو	—
`commit_message`	`object`	هو	—
`live_url`	`object`	هو	—
`message`	`object`	هو	Why it failed, else null. Rendered to the customer verbatim.
`requested_by`	`string`	هو	—
`created_at`	`string`	هو	—
`started_at`	`object`	هو	—
`finished_at`	`object`	هو	—
`log`	`string`	هو	The build log, one timestamped line per step. Truncated from the FRONT when long — the end of a build log is where the failure is.

تېروتنې چې دا پای ټکی یې بیرته راګرځولی شي

401 · 403 · 404 · 429

GET /v1/sites/{siteId}/deployments/{deploymentId}