Artikel 3 von 8

Die Dokumentation und der Testzugang

Eine vollständige Referenz der API und ein einsatzbereites Testkonto, um sie ohne Risiko auszuprobieren.

Die Referenz

Die Referenz der API (im OpenAPI-Format, in Swagger lesbar) beschreibt jeden für Fachleute geöffneten Aufruf: seine Parameter, seine Antworten, seine Beispiele und seine Fehlercodes. Sie umfasst:

  • Uhren und Uhrenpässe: Anlegen, Ändern, Fotos, Verknüpfung der Karte;
  • die Eigentümer: Meldung beim Verkauf, Eigentümerwechsel;
  • die Historie und die Garantie eines Uhrenpasses;
  • Ihre Fachhändler und Service-Center sowie Ihr Bestand bei ihnen;
  • die Bestellung einer Zertifizierung.

Sie ist ohne Zugangsdaten unter https://api.watchcertificate.org/api/v1/doc frei zugänglich.

Der Testzugang

Wir eröffnen für Sie ein Konto in unserer Testumgebung, getrennt von der Produktion. Es enthält:

  • ein validiertes Profi-Konto mit seinem Passwort;
  • seinen API-Schlüssel;
  • einen Satz Testkarten mit ihrer Nummer und ihrem Code;
  • Credits, um diese Karten zu verknüpfen;
  • einen Beispiel-Uhrenpass, um zu sehen, wie das Ergebnis aussieht.

Testkarten gibt es nur in der Testumgebung: In der Produktion ist jede Karte eine physische Karte, die mit der Uhr geliefert wird.

In die Produktion gehen

Die Aufrufe bleiben dieselben. Sie erstellen einen API-Schlüssel in Ihrem Produktivkonto, ändern die Adresse der API und verwenden Ihre echten Karten.

Nächster ArtikelWer ruft wen auf