hosting

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

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

ავტორიზაცია

API გასაღები გაგზავნეთ როგორც მატარებელი ტოკენი (bearer token). გასაღებს უნდა ჰქონდეს sites.manage ნებართვა; ამის გარეშე გასაღები უარყოფილი იქნება 403 და არა 404 სტატუსით.

ეს ბოლო წერტილი არ იღებს ორგანიზაციის იდენტიფიკატორს. თქვენი გასაღები უკვე აიდენტიფიცირებს იმ ორგანიზაციას, რომელსაც ის ეკუთვნის, და პასუხი შემოფარგლულია მისით.

სცადეთ

შეSubstituted any value inside angle brackets with your own and the key placeholder with a key from your dashboard.

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

შესული ხართ? თქვენი სამართავ პანელში არსებული API კონსოლი ავტომატურად ამატებს თქვენი რეალური ორგანიზაციის ID-სა და საკუთარ გასაღებს და ატარებს მოთხოვნას ცოცხალ API-ს წინააღმდეგ, რათა იხილოთ რეალური პასუხი. გაAღით ეს ენდპოინტი 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