GETMéthode GET/certificate/{identifier}/download

Vous récupérez un fichier PDF prêt à imprimer ou à joindre à un message : le certificat d'authenticité d'un article, aux couleurs de votre marque, en français ou en anglais.

L'adresse complète est https://api.sealtrust.io/v1/certificate/{identifier}/download. La même route existe sans le préfixe /v1, et c'est la forme /v1 qui est recommandée pour une nouvelle intégration.

En cas de succès, la réponse est le document lui-même, de type application/pdf, servi en pièce jointe. Écrivez le corps de la réponse dans un fichier. Ne tentez pas de le lire comme du texte.

Le serveur fabrique le document à chaque appel et ne le stocke nulle part. Deux appels successifs peuvent donc donner deux fichiers différents si l'état du certificat a changé entre-temps.

#Autorisation

Aucune, point d'entrée public. Il n'attend ni clef d'API, ni cookie de session, ni en-tête Authorization. Un appel serveur à serveur est accepté.

#Plafond d'appels

60 appels par fenêtre de 60 secondes, comptés par adresse IP appelante. Toutes les adresses qui commencent par /certificate partagent ce compteur, et la forme /v1/certificate/{identifier}/download compte dans le même compteur que la forme sans préfixe.

En temps normal, chaque réponse porte les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset, ce dernier donnant l'heure de remise à zéro en secondes depuis le 1er janvier 1970. Traitez ces trois en-têtes comme facultatifs : lisez-les quand ils sont là, ne faites pas dépendre votre intégration de leur présence. Un dépassement renvoie 429 avec en plus Retry-After, en secondes.

Ce point d'entrée ne consomme aucun quota de votre offre.

#Paramètres de chemin et de requête

#Les quatre formes de l'identifiant

Le serveur essaie d'abord le numéro de certificat. S'il n'aboutit pas, il regarde la forme de la valeur : 0x suivi de 64 caractères hexadécimaux est traité comme une empreinte d'article, toute autre valeur comme un identifiant de jeton. Une empreinte n'est donc jamais essayée comme identifiant de jeton, et l'inverse non plus. En dernier recours, le serveur essaie le numéro de série imprimé.

Les trois dernières formes désignent un article. Le serveur cherche alors le certificat de cet article : le certificat en cours de validité s'il en existe un, sinon le plus récent quel que soit son état.

Quand il résout ces trois formes, le serveur écarte les articles détruits et les articles retirés du catalogue, et répond 404. Le numéro de certificat ne passe pas par l'article : il trouve la ligne du certificat directement, et le document se télécharge même quand l'article a été détruit ou retiré du catalogue.

#La langue du document

fr et en sont les deux valeurs prévues, en minuscules. Une valeur qui ne commence ni par fr ni par en produit un document en anglais.

#Corps de la requête

Aucun. C'est une requête GET, tout passe par l'adresse.

curl -sS -D - \
  -o certificat.pdf \
  "https://api.sealtrust.io/v1/certificate/ST-CERT-000000000000/download?lang=fr"

import { writeFile } from "node:fs/promises";

const response = await fetch(
  "https://api.sealtrust.io/v1/certificate/ST-CERT-000000000000/download?lang=fr",
);

if (!response.ok) {
  throw new Error(`${response.status} ${await response.text()}`);
}

console.log(response.headers.get("Content-Type"));
console.log(response.headers.get("Content-Disposition"));
console.log(response.headers.get("X-RateLimit-Remaining"));

await writeFile("certificat.pdf", Buffer.from(await response.arrayBuffer()));

import requests

response = requests.get(
    "https://api.sealtrust.io/v1/certificate/ST-CERT-000000000000/download",
    params={"lang": "fr"},
    timeout=60,
)
response.raise_for_status()

print(response.headers["Content-Type"])
print(response.headers["Content-Disposition"])
print(response.headers["X-RateLimit-Remaining"])

with open("certificat.pdf", "wb") as fichier:
    fichier.write(response.content)

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename="certificate-ST-CERT-000000000000.pdf"
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1755000060