Hatalar
Hatalar
Her başarısızlık kararlı bir kod taşır. İletiye göre değil koda göre dallanın: ifade her an değişebilir, kod değişmez.
Yollar, yöntemler, kapsamlar, alan adları ve hata kodları İngilizce yayımlanır; çünkü arayüzün kendi dili İngilizcedir — çağrıyı yapanın yazdığı ya da eşleştirdiği şey budur. Aynısı her kod örneği, her JSON gövdesi ve bir hata yanıtının taşıdığı tam cümle için de geçerlidir: /v1, Accept-Language başlığını okumaz; API’nin gerçekte gönderdiğini çevirmek onu yanlış tanımlamak olurdu. Bunlar hakkında yazılan her şey bu sayfanın dilini izler.
Hata zarfı
2xx dışındaki her yanıt aynı biçimdedir. documentation_url doğrudan aşağıdaki ilgili maddeye işaret eder, request_id ise destek talebinde belirtilecek değerdir. details makine tarafından okunabilen bağlamı taşır; reddedilen bir gövde için bunlar issues girdileridir ve her biri sorunlu alanı gösteren bir JSON Pointer içerir.
{
"error": {
"code": "validation_failed",
"message": "The request body failed validation.",
"documentation_url": "https://passportcraft.com/docs/api/errors#validation_failed",
"request_id": "req_9Fv2KpQ0aXbT4Lmn",
"details": {
"issues": [
{ "source": { "pointer": "/data/product_name" }, "rule": "required" }
]
}
}
}Kodlar
Her kod, onu taşıyan yanıttan bağlantılıdır; bu sayfaya çoğunlukla doğrudan aranan maddenin üzerinde girilir.
invalid_key
401Verilen API anahtarı geçerli değil.
API şunu döndürürThe API key provided is not valid.
Bunu her uç nokta döndürebilir.
key_revoked
401Bu API anahtarı geçersiz kılınmış.
API şunu döndürürThis API key has been revoked.
Bunu her uç nokta döndürebilir.
key_expired
401Bu API anahtarının süresi dolmuş.
API şunu döndürürThis API key has expired.
Bunu her uç nokta döndürebilir.
key_rotated
401Bu API anahtarı bir yenileme ile değiştirilmiş ve iki anahtarın birlikte geçerli olduğu süre kapanmış.
API şunu döndürürThis API key was replaced by a rotation and its overlap window has closed.
Bunu her uç nokta döndürebilir.
mode_mismatch
400Anahtar ön eki kimlik bilgisiyle uyuşmuyor. Test anahtarı mı yoksa canlı anahtar mı kullanmak istediğinizi gözden geçirin.
API şunu döndürürThe key prefix does not match the credential. Check whether you meant a test or a live key.
Bunu her uç nokta döndürebilir.
insufficient_scope
403Bu kimlik bilgisi, bu işlem için gereken kapsamı taşımıyor.
API şunu döndürürThis credential does not carry the scope required for this operation.
Bunu hangi uç noktalar döndürür
- get
/organizations/{organization}/capabilities - get
/organizations/{organization}/events - get
/organizations/{organization}/passports - post
/organizations/{organization}/passports - get
/organizations/{organization}/passports/{id} - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - get
/organizations/{organization}/passports/{id}/links - get
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/affichage - get
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/units - get
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - post
/organizations/{organization}/imports - get
/organizations/{organization}/imports - get
/organizations/{organization}/imports/{id}
organization_not_found_or_not_granted
404Böyle bir kuruluş yok.
API şunu döndürürNo such organization.
Bunu hangi uç noktalar döndürür
- get
/organizations/{organization}/capabilities - get
/organizations/{organization}/events - get
/organizations/{organization}/passports - post
/organizations/{organization}/passports - get
/organizations/{organization}/passports/{id} - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - get
/organizations/{organization}/passports/{id}/links - get
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/affichage - get
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/units - get
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - post
/organizations/{organization}/imports - get
/organizations/{organization}/imports - get
/organizations/{organization}/imports/{id}
resource_not_found
404Böyle bir kaynak yok.
API şunu döndürürNo such resource.
Bunu hangi uç noktalar döndürür
- get
/categories/{category}/schema - get
/organizations/{organization}/passports/{id} - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - get
/organizations/{organization}/passports/{id}/links - get
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/affichage - get
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/units - get
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - get
/organizations/{organization}/imports/{id}
wildcard_not_supported
400"-" kuruluş joker karakteri ayrılmıştır ve henüz desteklenmiyor.
API şunu döndürürThe "-" organization wildcard is reserved and not yet supported.
Bunu hangi uç noktalar döndürür
- get
/organizations/{organization}/capabilities - get
/organizations/{organization}/events - get
/organizations/{organization}/passports - post
/organizations/{organization}/passports - get
/organizations/{organization}/passports/{id} - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - get
/organizations/{organization}/passports/{id}/links - get
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/affichage - get
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/units - get
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - post
/organizations/{organization}/imports - get
/organizations/{organization}/imports - get
/organizations/{organization}/imports/{id}
validation_failed
422İstek gövdesi doğrulamayı geçemedi.
API şunu döndürürThe request body failed validation.
Bunu hangi uç noktalar döndürür
- post
/organizations/{organization}/passports - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - post
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/imports
invalid_request
400İstek anlaşılamadı.
API şunu döndürürThe request could not be understood.
Bunu her uç nokta döndürebilir.
method_not_allowed
405Uç nokta var, ancak bu HTTP yöntemini yanıtlamıyor. Reddin Allow başlığı, yanıtladığı yöntemleri sıralar.
API şunu döndürürThis endpoint does not support that HTTP method. The Allow header lists the ones it does.
payload_too_large
413İstek gövdesi bu uç noktanın kabul ettiğinden büyük. Uygulanan tavanı details.limit_bytes bildirir.
API şunu döndürürThe request body is larger than this endpoint accepts.
Bunu her uç nokta döndürebilir.
unsupported_media_type
415İstek gövdesi application/json olarak gelmedi.
API şunu döndürürThe request body must be sent as application/json.
Bunu hangi uç noktalar döndürür
- post
/organizations/{organization}/passports - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/validate - post
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/imports
idempotency_conflict
409Bu Idempotency-Key değeri daha önce farklı bir istek gövdesiyle kullanılmış.
API şunu döndürürThis Idempotency-Key was already used with a different request body.
Bunu hangi uç noktalar döndürür
- post
/organizations/{organization}/passports - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/documents - post
/organizations/{organization}/imports
precondition_failed
412Kaynak, verdiğiniz sürümden bu yana değişmiş.
API şunu döndürürThe resource changed since the version you supplied.
resource_busy
409Bu kaynağı şu anda başka bir istek değiştiriyor. Retry-After başlığında belirtilen süreyi bekleyin, ardından yeniden deneyin.
API şunu döndürürAnother request is modifying this resource. Wait for the Retry-After header, then retry.
Bunu hangi uç noktalar döndürür
cursor_invalid
400Sayfalama imleci geçersiz, süresi dolmuş ya da farklı filtrelerle gönderilmiş.
API şunu döndürürThe pagination cursor is invalid, expired, or was sent with different filters.
no_subscription
402Bu kuruluşun etkin bir aboneliği yok.
API şunu döndürürThis organization has no active subscription.
Bunu hangi uç noktalar döndürür
- post
/organizations/{organization}/passports - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - post
/organizations/{organization}/imports
payment_overdue
402Ödeme gecikmiş durumdayken yayımlama kapalıdır.
API şunu döndürürPublishing is disabled while payment is overdue.
Bunu hangi uç noktalar döndürür
- post
/organizations/{organization}/passports - patch
/organizations/{organization}/passports/{id} - post
/organizations/{organization}/passports/{id}/publish - post
/organizations/{organization}/passports/{id}/unpublish - post
/organizations/{organization}/passports/{id}/trash - post
/organizations/{organization}/passports/{id}/restore - post
/organizations/{organization}/passports/{id}/affichage - post
/organizations/{organization}/passports/{id}/units - post
/organizations/{organization}/passports/{id}/documents - delete
/organizations/{organization}/passports/{id}/documents/{documentId} - post
/organizations/{organization}/imports
gtin_required
422Bu pasaportun yayımlanabilmesi için önce bir GTIN gerekir.
API şunu döndürürA GTIN is required before this passport can be published.
Bunu hangi uç noktalar döndürür
wrong_status
409Pasaport, bu işleme izin veren bir durumda değil.
API şunu döndürürThe passport is not in a status that allows this operation.
Bunu hangi uç noktalar döndürür
not_trashed
409Yalnızca çöp kutusundaki bir pasaport geri getirilebilir.
API şunu döndürürOnly a trashed passport can be restored.
Bunu hangi uç noktalar döndürür
publish_limit_reached
402Bu kuruluş, planının izin verdiği yayımlama haklarının tamamını kullanmış.
API şunu döndürürThis organization has used every publish slot its plan allows.
Bunu hangi uç noktalar döndürür
unit_limit_reached
402Bu pasaport, planın izin verdiğinden daha fazla birim taşıyor.
API şunu döndürürThis passport carries more units than the plan allows.
Bunu hangi uç noktalar döndürür
document_missing
422Zorunlu bir alan, yalnızca artık ekli olmayan bir belgeyle karşılanıyor.
API şunu döndürürA required field is satisfied only by a document that is no longer attached.
Bunu hangi uç noktalar döndürür
delegation_required
403Bildirim yapmak için, çağrı anında portal üzerinden doğrulanan etkin bir vekalet gerekir.
API şunu döndürürFiling requires an active delegation, verified against the portal at call time.
Bunu hangi uç noktalar döndürür
attestation_required
403Bu işlem, markada adı belirtilmiş bir kişinin kabul ettiği bir beyanı gerektirir.
API şunu döndürürThis operation requires an attestation accepted by a named person at the brand.
Bunu hangi uç noktalar döndürür
test_mode_refused
403Test kipindeki kimlik bilgileri bu işlemi gerçekleştiremez.
API şunu döndürürTest-mode credentials cannot perform this operation.
Bunu hangi uç noktalar döndürür
rate_limited
429Çok fazla istek.
API şunu döndürürToo many requests.
Bunu her uç nokta döndürebilir.
internal_error
500Bizim tarafımızda bir şeyler ters gitti.
API şunu döndürürSomething went wrong on our side.
Bunu her uç nokta döndürebilir.
configuration_error
500Hizmet yanlış yapılandırılmış. Bu, isteğinizden kaynaklanan bir sorun değil.
API şunu döndürürThe service is misconfigured. This is not a problem with your request.
Bunu her uç nokta döndürebilir.
Uyarılar
Uyarı bir ret değildir. Başarılı bir çağrıda, 200 yanıtının yanında gelir ve üzerine gidilmeye değer bir konuyu belirtir.
environmental_claim_detected
200Pasaport çevresel iddia niteliğinde ifadeler içeriyor. Yayımlama başarılı oldu ve pasaport yayında. 27 Eylül 2026 tarihinden itibaren (AB) 2024/825 sayılı Direktif, ürünü piyasaya arz eden tacirin bu tür iddiaları belgelendirmesini şart koşar.