hosting

POST `/v1/sites/{site_id}/translation/refresh`

Read the site again now, rather than waiting for the next pass.

प्रमाणीकरण

एपिआई कुञ्जीलाई बियरर टोकन (bearer token) को रूपमा पठाउनुहोस्। कुञ्जीसँग sites.manage अनुमति हुनुपर्छ; अनुमति नभएको कुञ्जीलाई 404 होइन, 403 मार्फत अस्वीकार गरिन्छ।

यो इन्डपोइन्टले कुनै संस्थाको आइडी लिँदैन। तपाईंको कुञ्जीले यस अन्तर्गत पर्ने संस्थालाई पहिल्यै पहिचान गर्छ, र प्रतिक्रिया त्यसैमा सीमित हुन्छ।

प्रयास गर्नुहोस्

कोणीय कोष्ठकभित्र भएका जुनसुकै कुरालाई आफ्नो मानहरूद्वारा बदल्नुहोस्, र मुख्य स्थानहोल्डरलाई तपाईंको ड्यासबोर्डको कुञ्जीद्वारा बदल्नुहोस्।

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

लगइन गर्नुभएको छ? तपाईंको ड्यासबोर्डमा रहेको API कन्सोलले तपाईंको वास्तविक संस्थाको आईडी र आफ्नै कुञ्जी भरिदिन्छ, र लाइभ API विरुद्ध अनुरोध चलाउँछ ताकि तपाईंले वास्तविक प्रतिक्रिया हेर्न सक्नुहोस्। यो एन्डपोइन्टलाई API कन्सोलमा खोल्नुहोस्

विवरणहरू

Re-reads the site's pages and posts and registers anything new or changed. The sweep does this on its own cadence; this is the button for a customer who has just published something and wants it translated now. **This is a point of spend**, so it asks good standing (`CLAUDE.md` §2.46) and the tier allowance before it reads anything. A `402` means the account is on hold — the body says so and says that it resumes automatically — or that the site now holds more words than the tier covers, with both numbers. Idempotent in the way that matters: content already registered at the same hash is a no-op that marks nothing stale and translates nothing again, so pressing the button twice costs nothing. Requires `sites.manage`.

प्यारामिटरहरू

नाम	प्रकार	आवश्यक	यो के हो
`site_id (path)`	`Uuid`	हुन्छ	—
`Idempotency-Key (header)`	`string`	हैन	Client-generated key that makes an unsafe request replay-safe: the server stores the first response and returns it verbatim for repeats.

प्रतिक्रिया

नाम	प्रकार	आवश्यक	यो के हो
`documents`	`integer`	हुन्छ	—
`words`	`integer`	हुन्छ	—
`fields_registered`	`integer`	हुन्छ	—
`fields_retired`	`integer`	हुन्छ	Sources removed because the site no longer has them. Reported rather than silent: a destructive step that says nothing is indistinguishable from one that did nothing.
`skipped_not_in_good_standing`	`boolean`	हैन	§2.46 — counted and surfaced, never silent. `documents: 0` because the account is on hold looks identical to a pass that could not see any work.
`refused`	`string`	हैन	Why nothing was read, empty when it was.

यो इन्डपोइन्टले फर्काउन सक्ने त्रुटिहरू

401 · 402 · 403 · 404 · 429

POST /v1/sites/{site_id}/translation/refresh