PassportCraft API-Dokumentation

Erstellen, aktualisieren und veröffentlichen Sie digitale Produktpässe direkt aus Ihren eigenen Systemen. Jeder Endpunkt gehört zu genau einer Organisation, und ein Zugangsschlüssel sieht ausschließlich die Organisationen, für die er freigegeben wurde.

API-Version: 2026-08-01
Basis-URL: https://passportcraft.com/api/v1
OpenAPI-3.1.0-Dokument: openapi.json
Endpunkte: 26

Pfade, Methoden, Scopes, Feldnamen und Fehlercodes erscheinen auf Englisch, denn Englisch ist die Sprache der Schnittstelle selbst — es ist das, was ein Aufrufer eintippt oder abgleicht. Ebenso jedes Codebeispiel, jede JSON-Nutzlast und der exakte Satz, den eine Fehlerantwort mitführt: /v1 wertet Accept-Language nicht aus, und eine Übersetzung dessen, was die API tatsächlich sendet, würde sie falsch beschreiben. Alles, was darüber geschrieben steht, folgt der Sprache dieser Seite.

Hier anfangen

Erste SchritteSchlüssel anlegen, erste Anfrage senden, dann einen Produktpass erstellen und veröffentlichen.AuthentifizierungWie ein Schlüssel übergeben wird, wie Test- und Live-Betrieb getrennt bleiben und welchen Scope jeder Endpunkt verlangt.KonventionenIdempotenz, Blätterung, bedingte Schreibvorgänge und die überall geltenden Limits.FehlerJede Ablehnung trägt einen stabilen Code. Alle 35 sind hier samt zugehörigem HTTP-Status aufgeführt.

Referenz

Eine Seite je Ressource. Jeder Endpunkt nennt seinen Scope, seine Parameter, seinen Anfragekörper, ein Antwortbeispiel und die Ablehnungen, die er zurückgeben kann.