HTTP API ve hata kodları
Tüm tarayıcı trafiği host’un sahip olduğu /__copypatch/api/v2 temel yolunda kalır. Güvenli olmayan yöntemler tam eşleşen same-origin Origin başlığı ister. Dahili oturumlarda geçerli x-copypatch-csrf başlığı da zorunludur.
| Yöntem | Yol | Erişim | Sonuç |
|---|---|---|---|
GET |
/health |
Genel | { "status": "ok" } veya { "status": "unavailable" } |
GET |
/content/:locale |
Genel | Yayınlanmış ContentSnapshot; zayıf revizyon ETag’lerini destekler |
POST, GET, DELETE |
/session |
Kimlik doğrulama akışı | Oturum oluşturur, okur veya temizler |
GET |
/editor/:locale |
editor veya publisher |
Tam EditorSnapshot |
PUT |
/editor/:locale/changes |
editor |
Beklenen revizyonlarla taslak değişiklikleri kaydeder |
POST |
/editor/:locale/publish |
publisher |
Taslakları yayınlanmış metne yükseltir |
DELETE |
/editor/:locale/drafts |
editor |
Beklenen revizyonlarla taslakları siler |
Hatalar
Hatalar { "error": { "code", "message" } } biçimini kullanır. Genel hata kodları VALIDATION_ERROR, UNAUTHENTICATED, CSRF_FAILED, ORIGIN_REJECTED, RATE_LIMITED, REVISION_CONFLICT, UNSUPPORTED_OPERATION, INTERNAL_ERROR ve NOT_FOUND değerleridir.
REVISION_CONFLICT, istemcinin bekleyen düzenlemelerini uzlaştırabilmesi için güncel editor snapshot’ını döndürür. Genel içerik okumaları, depolama geçici olarak kullanılamadığında en son bellek içi snapshot’a veya boş fallback değerine dönebilir.