hosting
GET /v1/sites/{site_id}/translation
Whether this site is translated, and how far along it is.
Аутентификација
Пошаљите API кључ као bearer токен. Кључ мора имати дозволу 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 site… |
last_error | string | Не | Why the last pass did nothing, in words the customer can act on. |
locales | SiteTranslationLocale[] | Да | — |
Грешке које ова крајња тачка може вратити
401 · 403 · 404