Article 3 of 8

The documentation and the test access

A complete reference of the API, and a test account ready to use, to try it without risk.

The reference

The API's reference (in the OpenAPI format, readable in Swagger) describes every call open to professionals: its parameters, its responses, its examples and its error codes. It covers:

  • watches and passports: creation, changes, photos, linking the card;
  • owners: declaration at the sale, change of owner;
  • a passport's history and warranty;
  • your retailers and service centers, and your stock with them;
  • ordering a certification.

It is open, with no credentials, at https://api.watchcertificate.org/api/v1/doc.

The test access

We open an account for you on our test environment, separate from production. It holds:

  • a validated professional account, with its password;
  • its API key;
  • a batch of test cards, with their number and code;
  • credits, to link those cards;
  • an example passport, to see what the result looks like.

Test cards exist only on the test environment: in production, each card is a physical card, delivered with the watch.

Going to production

The calls are the same. You create an API key on your production account, you change the API's address, and you use your real cards.

Next articleWho calls whom