localization
GET /v1/i18n/documents/{locale}
Get one marketing document's finished translations.
Tabbatar da Asali
Wannan yankin ƙarshen jama'a ne. Ba ya ɗaukar wata takardar shaida ko ƙungiya — shi ne abin da shafin kasuwancinmu da injunan amsa na AI ke karantawa.
Wannan wurin ƙarewa ba ya buƙatar ID na ƙungiya. Maɓallin ku ya riga ya gano ƙungiyar da yake ciki, kuma an iyakance amsa a kanta.
Gwada
May gurbin komai da ke cikin kusurwa da ƙimar ka, kuma may gurbin maballi da maballi daga allon sarrafa ka.
curl -X GET https://api.zinndigital.com/v1/i18n/documents/{locale}?object_ref=<object_ref>An shiga? Na'urar sarrafa API da ke cikin sashin kulawarka tana cika ainihin lambar ƙungiyarka da maɓallinka naka, sannan tana gudanar da buƙatar a kan ainihin API don haka zaka iya ganin amsar gaske. Buɗe wannan tashar a cikin na'urar kula da API
Bayani
Returns the finished translations for a single document, as field -> text across the surfaces a rendered page is built from (page, meta_title, meta_description, alt_text) — the read the public site performs on the server, per page, at render time. Why a second public endpoint next to getPublicMessageCatalogue. They are cached on different keys and answer different questions. The catalogue is one response per locale covering the shell (nav, footer, meta) and is read on every page; this is one response per document per locale, read only by the page it belongs to. Folding them together would churn the shell's cache entry whenever any of 60 marketing pages was retranslated. ⛔ object_ref is required. One locale's whole page surface is ~7,879 entries — the read scripts/i18n-pages.mjs batches at build time, and the one that OOM-killed the engine on 2026-08-05. Making the parameter optional would re-create that on a public, unauthenticated URL. A single document is ~131 leaves, which is what makes this safe on a render path behind an edge cache. Public and non-tenant, for the same reasons as the catalogue: the text is already in the page's HTML, and an Authorization header suppresses shared caching. up_to_date only — the site applies this over the document the current deploy already serves, so stale text could only replace a good translation with an older one. An untranslated document is a 200 with an empty fields object, never a 404 — the caller treats any failure as "use the build-time document", so a 404 would be indistinguishable from an outage. Cacheable: strong ETag plus Cache-Control: public, max-age=300, stale-while-revalidate=86400.
Sigogi
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
locale (path) | LocaleCode | Eh | The target locale (docs/28 registry code). |
object_ref (query) | string | Eh | The document, e.g. page:hosting. Required — see the description. |
If-None-Match (header) | string | A'a | A previously returned ETag; a match responds 304. |
Martani
| Suna | Nau'i | Ana buƙata | Abin da yake |
|---|---|---|---|
locale | LocaleCode | Eh | BCP-47 / ISO locale code from the language registry (docs/28). |
object_ref | string | Eh | The document these fields belong to, echoed back. |
fields | object | Eh | field -> translated text, flat. The field names are the ones the CMS walker (cms/src/lib/snapshotKeys.ts) assigns when it collects a document's translatable leaves, so the… |
Kuskuren da wannan matsaya za ta iya maido wa
422 · 429