Fouten

Fouten

Elke mislukking draagt een stabiele code. Vertak op de code en nooit op de melding: de formulering kan op elk moment veranderen, de code niet.

Paden, methoden, scopes, veldnamen en foutcodes staan in het Engels, want Engels is de taal van de koppeling zelf — het is wat een aanroeper typt of vergelijkt. Dat geldt ook voor elk codevoorbeeld, elke JSON-payload en de exacte zin die een foutantwoord meedraagt: /v1 leest Accept-Language niet, en een vertaling van wat de API werkelijk stuurt zou die verkeerd beschrijven. Alles wat erover geschreven staat, volgt de taal van deze pagina.

De foutenvelop

Elk antwoord buiten 2xx heeft dezelfde vorm. documentation_url wijst rechtstreeks naar het bijbehorende item hieronder, en request_id is de waarde om in een supportvraag te noemen. details draagt machineleesbare context — bij een geweigerd lichaam zijn dat de issues, elk een JSON Pointer naar het veld dat niet klopte.

Antwoord
{
  "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" }
      ]
    }
  }
}

Codes

Elke code is gelinkt vanuit het antwoord dat hem draagt, dus deze pagina wordt meestal meteen bij het benodigde item betreden.

invalid_key

401

De meegestuurde sleutel wordt niet herkend.

API stuurtThe API key provided is not valid.

Elk endpoint kan dit teruggeven.

key_revoked

401

De sleutel is ingetrokken en werkt niet meer.

API stuurtThis API key has been revoked.

Elk endpoint kan dit teruggeven.

key_expired

401

De geldigheidsduur van de sleutel is verstreken.

API stuurtThis API key has expired.

Elk endpoint kan dit teruggeven.

key_rotated

401

De sleutel is bij een rotatie vervangen en de overlapperiode is voorbij.

API stuurtThis API key was replaced by a rotation and its overlap window has closed.

Elk endpoint kan dit teruggeven.

mode_mismatch

400

Het voorvoegsel van de sleutel komt niet overeen met de inloggegevens. Ga na of u een test- of een productiesleutel bedoelde.

API stuurtThe key prefix does not match the credential. Check whether you meant a test or a live key.

Elk endpoint kan dit teruggeven.

invalid_request

400

Het verzoek kon niet worden begrepen.

API stuurtThe request could not be understood.

Elk endpoint kan dit teruggeven.

method_not_allowed

405

Het endpoint bestaat, maar beantwoordt deze HTTP-methode niet. De Allow-header op de weigering noemt de methoden die het wel beantwoordt.

API stuurtThis endpoint does not support that HTTP method. The Allow header lists the ones it does.

payload_too_large

413

Het verzoeklichaam is groter dan dit endpoint aanneemt. details.limit_bytes noemt het toegepaste plafond.

API stuurtThe request body is larger than this endpoint accepts.

Elk endpoint kan dit teruggeven.

precondition_failed

412

De bron is gewijzigd sinds de versie die u heeft meegestuurd.

API stuurtThe resource changed since the version you supplied.

Welke endpoints dit teruggeven

resource_busy

409

Een ander verzoek is deze resource aan het wijzigen. Wacht de tijd uit de Retry-After-header af en probeer het daarna opnieuw.

API stuurtAnother request is modifying this resource. Wait for the Retry-After header, then retry.

Welke endpoints dit teruggeven

cursor_invalid

400

De cursor is ongeldig of verlopen, of is met andere filters meegestuurd.

API stuurtThe pagination cursor is invalid, expired, or was sent with different filters.

Welke endpoints dit teruggeven

gtin_required

422

Zonder GTIN kan dit paspoort niet worden gepubliceerd.

API stuurtA GTIN is required before this passport can be published.

Welke endpoints dit teruggeven

not_trashed

409

Alleen een paspoort dat in de prullenbak ligt, kan worden hersteld.

API stuurtOnly a trashed passport can be restored.

Welke endpoints dit teruggeven

publish_limit_reached

402

De organisatie heeft alle publicatieplaatsen van haar abonnement gebruikt.

API stuurtThis organization has used every publish slot its plan allows.

Welke endpoints dit teruggeven

unit_limit_reached

402

Het paspoort draagt meer eenheden dan het abonnement toelaat.

API stuurtThis passport carries more units than the plan allows.

Welke endpoints dit teruggeven

document_missing

422

Een verplicht veld wordt alleen gedekt door een document dat niet langer gekoppeld is.

API stuurtA required field is satisfied only by a document that is no longer attached.

Welke endpoints dit teruggeven

delegation_required

403

Indienen kan alleen met een lopende delegatie, die bij de aanroep zelf bij het portaal wordt gecontroleerd.

API stuurtFiling requires an active delegation, verified against the portal at call time.

Welke endpoints dit teruggeven

attestation_required

403

Deze bewerking vereist een verklaring die door een met naam genoemde persoon bij het merk is aanvaard.

API stuurtThis operation requires an attestation accepted by a named person at the brand.

Welke endpoints dit teruggeven

test_mode_refused

403

Met inloggegevens in testmodus kan deze bewerking niet worden uitgevoerd.

API stuurtTest-mode credentials cannot perform this operation.

Welke endpoints dit teruggeven

portal_unavailable

502

Het Franse affichage-portaal was niet bereikbaar, dus er is niets ingediend.

API stuurtThe French affichage portal could not be reached, so nothing was filed.

Welke endpoints dit teruggeven

storage_unavailable

503

We konden niet bevestigen of de geüploade bestanden in de opslag staan, dus er is niets gepubliceerd. Er is niets mis met uw verzoek — probeer het opnieuw na de wachttijd uit de Retry-After-header.

API stuurtWe 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.

Welke endpoints dit teruggeven

entitlement_unavailable

503

We konden de rechten van deze organisatie niet bevestigen, dus er is niets ingediend. Dit zegt niets over het abonnement — probeer het opnieuw na de wachttijd uit de Retry-After-header.

API stuurtWe 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.

Welke endpoints dit teruggeven

rate_limited

429

Er zijn te veel verzoeken in korte tijd gedaan.

API stuurtToo many requests.

Elk endpoint kan dit teruggeven.

internal_error

500

Er is bij ons iets misgegaan.

API stuurtSomething went wrong on our side.

Elk endpoint kan dit teruggeven.

configuration_error

500

De dienst is verkeerd geconfigureerd. Aan uw verzoek ligt het niet.

API stuurtThe service is misconfigured. This is not a problem with your request.

Elk endpoint kan dit teruggeven.

Waarschuwingen

Een waarschuwing is geen weigering. Ze komt binnen naast een 200, bij een aanroep die is geslaagd, en wijst op iets dat aandacht verdient.

environmental_claim_detected

200

Het paspoort bevat milieuclaims. Het publiceren is geslaagd en het paspoort staat online. Vanaf 27 september 2026 vereist Richtlijn (EU) 2024/825 dat de handelaar die het product op de markt brengt onderbouwing voor zulke claims heeft.

Fouten — PassportCraft-API | PassportCraft