Hatalar — PassportCraft API

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ı, hata kodları ve doğrulama kuralı adları İ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.

Yanıt

{
  "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

401

Verilen 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

401

Bu 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

401

Bu 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

401

Bu 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

400

Anahtar ö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

403

Bu 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

organization_not_found_or_not_granted

404

Böyle bir kuruluş yok ya da bu anahtarın o kuruluş için yetkisi yok. Yetki, biri onu geçersiz kıldığında ya da kuruluşun iş ortağıyla iş birliği sona erdiğinde biter; kuruluş bundan sonra GET /organizations yanıtında yer almaz.

API şunu döndürürNo such organization.

Bunu hangi uç noktalar döndürür

resource_not_found

404

Böyle bir kaynak yok.

API şunu döndürürNo such resource.

Bunu hangi uç noktalar döndürür

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

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

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

405

Uç 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

idempotency_conflict

409

Bu 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

already_exists

409

Bu tanımlayıcıyı taşıyan bir kaynak zaten var.

API şunu döndürürA resource with this identifier already exists.

Bunu hangi uç noktalar döndürür

gtin_in_use

409

Bu GTIN başka bir pasaporta ait. details, passport, product_name ve role (lead veya variant) alanlarını içerir. O pasaportu veya başka bir GTIN kullanın.

API şunu döndürürThis GTIN belongs to another passport. Use that passport or choose a different GTIN.

Bunu hangi uç noktalar döndürür

variant_limit_reached

422

Bu pasaport varyant sınırına ulaştı. details içinde limit, current ve requested bulunur. Daha fazla varyant eklemek için ikinci bir pasaport oluşturun. Bu sınır plandan bağımsızdır.

API şunu döndürürThis passport has reached its variant limit. Create a second passport to add more.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/variants

variant_review_required

409

Bu pasaportta bir asistanın girdiği beden ve renkler var. Önce bir kişi bunları gözden geçirir: GET …/variants/review adresini okuyun, ardından parmak iziyle yayımlayın. details, agent_written_count ve gözden geçirme URL’sini içerir.

API şunu döndürürThis passport carries sizes and colours an assistant wrote. A person reviews them first: read the review, then publish with its fingerprint.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/publish

variant_review_changed

409

Beden ve renkler, bu parmak izinin işaret ettiği gözden geçirmeden sonra değişti. Gözden geçirmeyi yeniden okuyun ve güncel parmak iziyle yayımlayın. details, agent_written_count içerir.

API şunu döndürürThe sizes and colours changed after the review this fingerprint names. Read the review again and publish with its current fingerprint.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/publish

precondition_failed

412

Kaynak değişti: ya verdiğiniz sürümden bu yana ya da isteğiniz işlenirken. Bildirdiğimiz current_version, okuduğumuz sürümdür; şu anda saklanan sürüm olmak zorunda değildir — bundan hesap yapmak yerine pasaportu yeniden okuyun.

API şunu döndürürThe resource changed since the version you supplied.

Bunu hangi uç noktalar döndürür

resource_busy

409

Bu 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

delete/organizations/{organization}/passports/{id}/documents/{documentId}

cursor_invalid

400

Sayfalama 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.

Bunu hangi uç noktalar döndürür

no_subscription

402

Bu 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

plan_required

402

Bu kuruluşun planı bu işlemi kapsamıyor.

API şunu döndürürThis organization’s plan does not include this operation.

Bunu hangi uç noktalar döndürür

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

gtin_required

422

Bu 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

409

Pasaport, 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

409

Yalnı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

post/organizations/{organization}/passports/{id}/restore

publish_limit_reached

402

Bu 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

post/organizations/{organization}/passports/{id}/publish

unit_limit_reached

402

Bu 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

422

Zorunlu 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

post/organizations/{organization}/passports/{id}/publish

document_feeds_extraction

409

Bu belge, bir pasaportun değerlerinin nereden geldiğinin kaydıdır; bu nedenle o pasaport var oldukça saklanır. Hiçbir bağlantı kaldırılmadı.

API şunu döndürürThis document is the record of where a passport’s values came from, so it stays while that passport exists. Nothing was detached.

Bunu hangi uç noktalar döndürür

delete/organizations/{organization}/passports/{id}/documents/{documentId}

document_feeds_reading

409

Bu belge, kaydedilmiş pil değerlerini destekler ve ilgili pil kayıtları var olduğu sürece silinemez. Kayıtları incelemek için pil modelini açın.

API şunu döndürürThis document supports recorded battery values and cannot be deleted while those battery records exist. Open the battery model to review those records.

invalid_input

400

İ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/{id}/units/{unitId}/readings

invalid_observed_on

400

İ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/{id}/units/{unitId}/readings

invalid_source

400

İ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/{id}/units/{unitId}/readings

invalid_field

400

İ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

invalid_note

400

İ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/{id}/units/{unitId}/readings

invalid_value

400

İ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/{id}/units/{unitId}/readings

invalid_document_id

400

İ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/{id}/units/{unitId}/readings

unit_status_required

400

Bu pilin zaten bir durumu var. Durumu temizlemek yerine başka bir durum seçin.

API şunu döndürürThis battery already has a status. Choose a status instead of clearing it.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/units/{unitId}/readings

unit_status_transition_forbidden

409

Bir pil, başka bir durumdan sonra Özgün durumuna dönemez veya Atık durumundan sonra durumunu değiştiremez.

API şunu döndürürThis battery’s status cannot return to Original or change after Waste.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/units/{unitId}/readings

unit_status_history_conflict

409

Bu durum, pilin kayıtlı geçmişiyle çelişir. Tarihi ve durumu kontrol edin.

API şunu döndürürThis status would conflict with the battery’s recorded history. Check the date and status.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/units/{unitId}/readings

unit_reading_document_unavailable

400

Böyle bir kaynak yok.

API şunu döndürürNo such resource.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/units/{unitId}/readings

delegation_required

403

Bildirim 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

post/organizations/{organization}/passports/{id}/affichage

attestation_required

403

Bu 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

post/organizations/{organization}/passports/{id}/affichage

test_mode_refused

403

Test 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

post/organizations/{organization}/passports/{id}/affichage

human_approval_required

202

Bağlayıcı yayımlama talebinde bulundu. Kuruluştaki bir kişinin bunu onaylaması gerekir ve hiçbir şey yayımlanmadı.

API şunu döndürürA person at your organization must approve this publish. The request was recorded and is waiting for them — give them the link in `details.review_url`. Nothing has been published.

connector_writes_drafts_only

409

Aracı bağlayıcı yalnızca taslağı değiştirebilir. Kamunun zaten gördüğü bir pasaport için bir kişi gerekir.

API şunu döndürürThis product is already visible to the public, so an assistant cannot change it. A person has to make the change — give them the editor link in `details.review_url`.

Bunu hangi uç noktalar döndürür

unit_status_not_allowed

422

Ayrıntılarda belirtilen izin verilen beş pil durumundan birini seçin.

API şunu döndürürChoose one of the five permitted battery statuses in `details.allowed`, or leave the status empty.

portal_unavailable

502

Fransız portalı zamanında yanıt vermedi. Beyanınız kaydedilmiş de olabilir, kaydedilmemiş de. İsteği yeni bir Idempotency-Key ile yeniden gönderin — hiçbir şey iki kez beyan edilmez. Aynı anahtarı yeniden kullanmak yalnızca bu hatayı bir kez daha döndürür.

API şunu döndürürThe French affichage portal did not answer. If the declaration had already been sent, it may still have been recorded — check the passport before filing it again.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/affichage

storage_unavailable

503

Yüklenen dosyaların depolamada bulunup bulunmadığını doğrulayamadık, bu nedenle hiçbir şey yayımlanmadı. İsteğinizde bir sorun yok — Retry-After başlığında belirtilen süreden sonra yeniden deneyin.

API şunu döndürürWe could not confirm whether the uploaded files are in storage, so nothing was published. Nothing is wrong with your request — retry after the delay in the Retry-After header.

Bunu hangi uç noktalar döndürür

entitlement_unavailable

503

Bu kuruluşun yetkisini doğrulayamadık, bu nedenle hiçbir şey sunulmadı. Bu, abonelik hakkında bir tespit değildir — Retry-After başlığında belirtilen süreden sonra yeniden deneyin.

API şunu döndürürWe could not confirm this organization’s entitlement, so nothing was filed. This is not a statement about the plan — retry after the delay in the Retry-After header.

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/passports/{id}/affichage

scope_exceeds_key

422

İstenen yetki, anahtarın kendi kuruluşunda sahip olmadığı bir kapsamı içeriyor. Bir müşteri için verilen yetki, anahtarın kendi yetkisini hiçbir zaman aşmaz.

API şunu döndürürA grant cannot carry a scope the key does not hold on its own organization

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/grants

france_mandate_required

403

filings:write kapsamı bu müşteri için henüz verilemez. Önce kuruluşunuzdan bir kişinin, müşterinin çalışma alanında, Fransa'da beyan sunmak için bu müşterinin yazılı yetkisine sahip olduğunuzu onaylaması gerekir.

API şunu döndürürfilings:write needs the client's written authorisation, affirmed in its workspace, before it can be granted

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/grants

grantor_not_seated

403

Çağrıyı yapan anahtarı oluşturan kişinin bu müşterinin çalışma alanında artık bir koltuğu yok; bu nedenle yetkiyi veren kişi olarak kimse kaydedilemez. Ayarlar bölümünde yeni bir anahtar oluşturun.

API şunu döndürürThe person who created this key no longer holds a seat in this organization

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/grants

key_not_grantable

409

key_id ile belirtilen anahtar şu durumlardan birinde: geçersiz kılınmış, süresi dolmuş, değiştirilme sürecinde ya da bir asistan bağlantısına ait. Bu durumdaki hiçbir anahtara yetki verilemez.

API şunu döndürürThis key cannot be granted: it is revoked, expired, being replaced, or an assistant connection

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/grants

grant_conflict

409

Anahtarın burada farklı kapsamlarla verilmiş bir yetkisi zaten var. Önce bu yetkiyi geçersiz kılın, ardından istediğiniz kapsamlarla yeniden yetki verin.

API şunu döndürürThis key already holds a grant here with different scopes; revoke it, then grant again

Bunu hangi uç noktalar döndürür

post/organizations/{organization}/grants

rate_limited

429

Çok fazla istek.

API şunu döndürürToo many requests in a short time. Wait a moment, then try again.

Bunu her uç nokta döndürebilir.

internal_error

500

Bizim 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

500

Hizmet 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.

PassportCraft uygulamasından gelen ret yanıtları

Oturum açtığınız uygulama kendi rotalarını çağırır ve bu rotalar aşağıdaki kodlarla reddeder. Bunlar /v1 sözleşmesinin parçası değildir ve değişebilir. Uygulamada gördüğünüz bir mesajın veya bir yardım makalesinin işaret edebileceği bir yer olsun diye burada listelenmiştir.

billing_managed_by_partner

Çalışma alanının iş ortağı, faturalandırmasını yönetir. Ödeme adımı, faturalandırma portalı ve plan değişikliklerinin tümü bu kodla reddedilir.

API şunu döndürürBilling for this workspace is managed by the partner that pays for it

partner_role_fixed

Bu kişi çalışma alanının iş ortağı için çalışıyor. Buradaki rolü, iş ortağındaki rolünü izler ve değiştirilemez; bir sahip veya yönetici bu kişiyi kaldırabilir.

API şunu döndürürA partner member's role follows their role at the partner

home_members_only

Bunu yalnızca çalışma alanının kendi sahibi veya yöneticileri yapabilir; örneğin bir iş ortağını kabul etmek, reddetmek veya durdurmak gibi. Bir iş ortağının personeli, rolü ne olursa olsun bunu yapamaz. Bir anahtarı ancak kendi iş ortağının personeli bu çalışma alanında oluşturmuşsa ve anahtar yalnızca bu çalışma alanı üzerinde işlem yapıyorsa yenileyebilir.

API şunu döndürürOnly the workspace's own owner or administrator can do this

client_already_linked

Bu çalışma alanının zaten bir iş ortağı var veya henüz yanıtlamadığı bir iş ortağı isteği var.

API şunu döndürürThis workspace already has a partner, or a request it has not answered

partner_chain_not_allowed

Çalışma alanı zaten müşterileri yönetiyor veya zaten bir iş ortağı tarafından yönetiliyor. Bir kuruluş ya iş ortağı ya da bir iş ortağının müşterisi olabilir, ikisi birden olamaz. Bu nedenle bu iş birliği başlatılamaz.

API şunu döndürürAn organization can manage clients or be managed by a partner, not both

not_a_partner

X-Organization içinde adı geçen kuruluş herhangi bir müşteriyi yönetmiyor.

API şunu döndürürThis organization does not manage clients

partner_staff_only

Bunu yalnızca yöneten iş ortağının kendi personeli yapabilir; örneğin bir müşterinin Fransız coût environnemental beyanları için verdiği yazılı yetkiyi onaylamak gibi.

API şunu döndürürOnly the partner's staff can do this

link_not_found

Bu çalışma alanı için bu kimlikle eşleşen bir iş ortaklığı yok.

API şunu döndürürLink not found

link_not_pending

Bu istek zaten yanıtlandı.

API şunu döndürürThis request has already been answered

link_not_accepted

İş ortaklığı etkin değil: henüz yanıt bekliyor veya sona ermiş.

API şunu döndürürThis link is not active

same_organization

Bir kuruluş kendi kendini yönetemez.

API şunu döndürürAn organization cannot manage itself

organization_not_found

Verilen adres veya e-postayla eşleşen bir çalışma alanı yok.

API şunu döndürürOrganization not found

organization_header_required

İstek bir çalışma alanı adı vermedi. Çalışma alanının slug değerini X-Organization başlığında gönderin.

API şunu döndürürThe X-Organization header is required

organization_not_a_member

Oturum açan kişi, X-Organization içinde adı geçen çalışma alanının üyesi değil.

API şunu döndürürNot a member of this organization

continuity_pending

İş ortağının ödediği plan hâlâ sürüyor. Bu çalışma alanının faturalandırması, ödemenin kapsadığı tarihte değişir.

API şunu döndürürThe current plan runs to the date it was paid to; billing for this workspace changes after that

partner_terms_missing

Bu iş ortağı için henüz kayıtlı faturalandırma koşulu yok, bu yüzden hesabında henüz bir plan açılamaz.

API şunu döndürürThis partner has no billing terms recorded

partner_customer_missing

İş ortağının henüz bir ödeme hesabı yok.

API şunu döndürürThis partner has no payment account yet

partner_card_missing

İş ortağının kayıtlı bir ödeme yöntemi yok. Bunu kendi Faturalandırma sayfasından ekler.

API şunu döndürürThis partner organization has no payment method on file

client_already_subscribed

Bu çalışma alanı zaten kendi aboneliği için ödeme yapıyor.

API şunu döndürürThis workspace already has its own subscription

plan_below_current

Seçilen plan, bu çalışma alanının şu anda bulunduğu plandan daha küçük.

API şunu döndürürThat plan is smaller than the one this workspace is on

continuity_not_available

Bu çalışma alanı için sürdürülecek, önceki bir iş ortağı tarafından ödenmiş bir dönem yok.

API şunu döndürürThere is nothing to continue on this workspace

yearly_not_accepted

Bir iş ortağının hesabında yıllık plan açmak için önce iş ortağının yıllık süreyi yazılı olarak kabul ettiğinin kaydedilmesi gerekir.

API şunu döndürürThis partner has not accepted the annual term in writing; record it before opening a yearly plan

stripe_refused

Ödeme sağlayıcısı isteği reddetti.

API şunu döndürürStripe refused the request

payment_pending

Ödemenin sonucu henüz bilinmiyor. Mevcut isteğin durumunu kontrol edin; başka müşteri oluşturmayın veya başka ödeme göndermeyin.

API şunu döndürürThe payment result is not yet known. Check its status before starting another payment.

price_changed

Onaylanan fiyat son önizlemeden farklı. Yeniden göndermeden önce güncel fiyatı gözden geçirin. Müşteri oluşturulmadı.

API şunu döndürürThe price changed. Review the current amount before creating the client.

price_unavailable

Fiyat önizlemesi kullanılamıyor. Müşteriyi oluşturmadan önce önizlemeyi yeniden yükleyin. Müşteri oluşturulmadı.

API şunu döndürürThe price is unavailable. No client was created. Try the review again later.

price_changed_after_create

Müşteri ücretsiz planda oluşturuldu. Fiyat değişti ve ödenmemiş ödeme girişimi güvenli biçimde kapatıldı. Planı etkinleştirmek için destek ekibiyle iletişime geçin; müşteriyi yeniden oluşturmayın.

API şunu döndürürThe client was added on Free. The reviewed payment did not proceed. Contact support to activate the plan.

creation_token_invalid

Bu gözden geçirme kullanıcı, çalışma alanı veya müşteri bilgileriyle eşleşmiyor. Doğru bilgileri yeniden gözden geçirin. Bir oluşturma isteği zaten gönderildiyse ve sonucu bilinmiyorsa yeniden başlamak yerine destek ekibiyle iletişime geçin.

API şunu döndürürThis creation review is invalid. If creation has already started, check its status or contact support.

creation_token_expired

Oluşturma yetkisinin süresi doldu. Önce mevcut oluşturma isteklerini kontrol edin; hiç istek gönderilmediyse ödemeyi yeniden gözden geçirin.

API şunu döndürürThis creation review expired. Check any existing operation before reviewing a new creation.

creation_operation_expired

Bu oluşturma isteğinin saklanan durumu artık kullanılamıyor. Başka işlem yapmadan önce destek ekibiyle iletişime geçin; müşteriyi yeniden oluşturmayın.

API şunu döndürürThis operation status is no longer available. Contact support before creating another client.

creation_conflict

Bu oluşturma isteği zaten farklı bilgilere bağlı. İlk isteği kontrol edin veya destek ekibiyle iletişime geçin; başka oluşturma işlemi başlatmayın.

API şunu döndürürThis operation belongs to different creation details. Check the original operation or contact support.

creation_unavailable

Oluşturma öncesi gözden geçirme kullanılamıyor. Daha sonra tekrar deneyin. Bir oluşturma isteğinin sonucu bilinmiyorsa yeniden göndermek yerine durumunu kontrol edin.

API şunu döndürürCreation review is unavailable. Try again later; check the status of any creation already started.

client_not_managed

Adı geçen kuruluş, sizin kuruluşunuzun yönettiği bir müşteri değil.

API şunu döndürürThat organization is not a client your organization manages

keys_admin_partner_only

keys:admin yalnızca müşterileri yöneten bir kuruluşa ait bir anahtara verilebilir.

API şunu döndürürkeys:admin can only be granted on the own keys of an organization that manages clients

grant_not_found

Başka bir kuruluşa ait hiçbir anahtar bu kimlikle bu çalışma alanına erişime sahip değil.

API şunu döndürürNo key from another organization holds a grant here under that id

Doğrulama kuralları

Bunlar, pasaport verisinin kendisinin ihlal edebileceği kurallardır ve her kategoride geçerlidir. Bir kural adı size üç yerde ulaşır: 422 yanıtında error.details.issues altında, doğrulama uç noktasının 200 yanıtında issues altında ve toplu içe aktarma satırında error.detail.issues altında. Oluşturma, güncelleme ve içe aktarma, data içindeki bir değeri yalnızca kaydederken reddedilir olarak işaretlenmiş iki kural için reddeder; ayrıca oluşturma, hizmet vermediği bir kategori için required döndürür. Geri kalanlar yayımlamadan ya da doğrulama uç noktasından gelir. Yayımlama, bilgilendirmeler dahil listenin tamamını döndürür; bu yüzden reddin nedeni olmayan kuralları da adlandırır. Kodunuzu kurala göre yazın, mesaja göre değil.

required

yayımlamayı engeller

Alan bu kategori için zorunludur ve boş, eksik ya da boş liste olarak geldi. Hizmet vermediğimiz bir kategoride pasaport oluşturmak da /category JSON Pointer değerinde aynı kuralı döndürür.

Nasıl düzeltilirBir değer gönderin. Bir dosyayı belgeleyen url alanı, bunun yerine o belgeyi eklediğinizde de karşılanır.

type_array

yayımlamayı engellerkaydederken de reddedilir

Alan bir liste tutar, gönderilen değer ise liste değildi — çoğunlukla JSON metni olarak gönderilen bir liste.

Nasıl düzeltilirGerçek bir JSON dizisi gönderin, diziyi içeren bir metin değil.

type_array_items

yayımlamayı engellerkaydederken de reddedilir

Alan düz metin değerlerinden oluşan bir liste tutar ve en az bir öğe nesne, sayı veya mantıksal değerdi.

Nasıl düzeltilirHer öğeyi metin olarak gönderin. Bunu gerektiren alan, kategori şemasında item_type taşır.

type_number

yayımlamayı engeller

Alan bir sayı tutar, gönderilen değer ise sayı değildi — çoğunlukla metin olarak gönderilen bir sayı.

Nasıl düzeltilirTırnaksız bir JSON sayısı gönderin.

type_text

yayımlamayı engeller

Alan metin tutar ve değer metin değildi — çoğunlukla kategori şemasının metin olarak tanımladığı bir alana ya da serbest yanıt da kabul eden bir seçim alanına gönderilen sayı, boole değeri veya liste.

Nasıl düzeltilirDeğeri JSON dizesi olarak gönderin. Kategori şemasındaki alanın type değerini okuyun. other seçeneği sunan bir select, serbest yanıtı da dize olarak alır.

number_min

yayımlamayı engeller

Değer, alanın kabul ettiği en küçük sayının altında.

Nasıl düzeltilirKategori şemasında alanın min değerini okuyun ve ona eşit ya da ondan büyük bir değer gönderin.

number_max

yayımlamayı engeller

Değer, alanın kabul ettiği en büyük sayının üstünde.

Nasıl düzeltilirKategori şemasında alanın max değerini okuyun ve ona eşit ya da ondan küçük bir değer gönderin.

format_date

yayımlamayı engeller

Değer geçerli bir ISO 8601 tarihi değil. 2025-02-30 gibi var olmayan bir tarih burada reddedilir.

Nasıl düzeltilirYYYY-MM-DD ya da Z ile biten, UTC cinsinden tam bir ISO 8601 zaman damgası gönderin. Zaman damgasını başka bir tarihe taşıyan bir saat farkı reddedilir.

format_url

yayımlamayı engeller

Değer geçerli bir URL değil.

Nasıl düzeltilirhttps:// veya http:// ile başlayan tam bir URL gönderin.

invalid_option

yayımlamayı engeller

Alan sabit bir değer kümesi kabul eder ve gönderilen değer bunlardan biri değildi. other seçeneği sunan bir alan bunun dışındadır: serbest metni saklar.

Nasıl düzeltilirKategori şemasında alanın options değerini okuyun ve orada listelenen value girdilerinden birini gönderin.

format_gtin

yayımlamayı engeller

GTIN gerçek değil: boş metin olarak geldi, rakam olmayan karakterler içeriyor, uzunluğu yanlış, kontrol hanesi tutmuyor ya da bir belge örneği.

Nasıl düzeltilirGS1 tarafından size tahsis edilmiş bir GTIN-8, GTIN-12, GTIN-13 veya GTIN-14 gönderin. Mesaj, hangi sorun olduğunu belirtir.

format_eori

yayımlamayı engeller

EORI numarası, alanın kabul ettiği biçime uymuyor.

Nasıl düzeltilirİki büyük harfli ülke kodu, ardından 1 ila 15 büyük harf veya rakam gönderin. Küçük harfler reddedilir.

format_country_code

yayımlamayı engeller

Ülke iki büyük harften oluşmuyor. Küçük harfli bir kod reddedilir: DE yerine de.

Nasıl düzeltilirBüyük harfli ISO 3166-1 alfa-2 kodu gönderin, örneğin DE.

format_commodity_code

bilgilendirme

Eşya kodu HS, CN veya TARIC biçimine uymuyor.

Nasıl düzeltilir6, 8 veya 10 rakam gönderin. Pasaportu değeri olduğu gibi bırakarak da yayımlayabilirsiniz.

format_email

yayımlamayı engeller

Değer geçerli bir e-posta adresi değil.

Nasıl düzeltilirEksiksiz bir adres gönderin.

category_exists

yayımlamayı engeller

Pasaport, bu API'nin hizmet vermediği bir ürün kategorisi belirtiyor.

Nasıl düzeltilirBaşka bir kategori göndermek bunu gidermez: kayıtlı pasaport, artık hizmet vermediğimiz bir kategoriyi belirtiyor. Kategorileri listeleyen uç noktanın döndürdüğü bir kategoride yeniden oluşturun.

Kural adı taşıyan üç şey daha vardır. Bir ürün kategorisi, birkaç alanı birlikte okuyan kendi kurallarını ekler — örneğin toplamı 100 olması gereken malzeme yüzdeleri. Bir uç nokta, isteğin kendisiyle ilgili sorunu aynı biçimde not_writable gibi adlarla bildirir. Yayımlama denetimi ise required adını, yayımlamanın gerektirdiği bir değer için — örneğin bir GTIN — kategorinin kendisinin zorunlu tutmadığı bir alanda yeniden kullanır. Her durumda yanıttaki mesaj kuralı açıklar.

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

200

Pasaport, ifadelerinde veya markanın çevresel bilgi olarak işaretlediği alanlarda yer alan çevresel iddialar 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.