hosting

GET `/v1/sites/{site_id}/translation`

Whether this site is translated, and how far along it is.

Նույնականացում

Ուղարկեք API բանալին որպես bearer token: Բանալին պետք է ունենա sites.view թույլտվությունը. առանց դրա բանալին մերժվում է 403, և ոչ թե 404 կարգավիճակով:

Այս վերջնակետը կազմակերպության ID չի ընդունում: Ձեր բանալին արդեն իսկ նույնականացնում է այն կազմակերպությունը, որին պատկանում է, և պատասխանը սահմանափակված է դրանով:

Փորձել

Փոխարինեք անկյունային փակագծերում գտնվող ցանկացած բան ձեր սեփական արժեքներով, և բանալու տեղապահը՝ ձեր վահանակի բանալիով:

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

Մուտք գործե՞լ եք: Ձեր վահանակի API վահանակը լրացնում է ձեր իրական կազմակերպության ID-ն և ձեր սեփական բանալին և գործարկում է հարցումը ուղիղ API-ի դեմ, որպեսզի կարողանաք տեսնել փաստացի պատասխանը: Բացեք այս վերջնակետը API վահանակում

Մանրամասներ

The state of Site Translation for one site: whether it is bought, which tier, how many words and documents we measured, when we last read the site, and per-locale progress. **A site with no subscription is a `200`, not a `404`.** The screen needs to render the offer, and "not bought" is an answer about a site that exists — returning `404` would make a site the customer owns look missing. `locales[]` reports every language with its own counts, and `served` says whether the customer has switched that language on for visitors. ⛔ `translated` and `served` are separate numbers on purpose: every tier translates every language, so a locale can be 100% translated and reach nobody because its owner has not enabled it. Merging them would report either a coverage figure nobody is served by, or a delivery figure that understates what is ready — the two mistakes `docs/28` was rewritten to stop making. Readable whether or not the account is in good standing: a customer behind on an invoice may still see what they have already paid for. Requires `sites.view`.

Պարամետրեր

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`site_id (path)`	`Uuid`	Այո	—

Պատասխան

Անուն	Տեսակ	Պահանջվում է	Ինչ է դա
`site_id`	`Uuid`	Այո	UUIDv7 identifier — sortable by creation time (docs/02 §8).
`state`	`string<disabled, active, paused_standing, over_allowance>`	Այո	⛔ `paused_standing` is its own state, not a flavour of `disabled` — the remedies differ and only one of them is the customer's to act on.
`tier`	`SiteTranslationTier`	Այո	—
`available_tiers`	`SiteTranslationTier[]`	Այո	The ladder, so the screen never hardcodes a price.
`word_count`	`integer`	Այո	Translatable words measured at the last read.
`document_count`	`integer`	Այո	—
`last_extracted_at`	`string`	Ոչ	When we last successfully read the site. ⛔ Distinct from the attempt cursor the sweep keeps: a failed pass advances that and must not move this, or the screen would report a sit…
`last_error`	`string`	Ոչ	Why the last pass did nothing, in words the customer can act on.
`locales`	`SiteTranslationLocale[]`	Այո	—

Այս վերջնակետի կողմից վերադարձվող սխալները

401 · 403 · 404

GET /v1/sites/{site_id}/translation