POSTMéthode POST/originality/read-sig/verify

Vous envoyez le numéro de série d'une puce et la signature d'originalité NXP Read_Sig lue dessus, et le service vous renvoie un verdict.

#Autorisation

Aucune, point d'entrée public. Ce point d'entrée n'attend ni clef d'API, ni cookie de session, ni en-tête Authorization.

Appelez-le depuis votre serveur. Un appel émis par une page de navigateur passe par deux contrôles supplémentaires, l'origine de la requête et le jeton anti-falsification, qui renvoient 403 quand ils ne sont pas satisfaits.

Le contrôle ne touche à aucun de vos enregistrements. Aucun scan n'est enregistré, aucune statistique n'est alimentée, aucune notification n'est déclenchée.

#Plafond d'appels

Aucun plafond propre à ce point d'entrée. Il relève du compteur général de l'API, compté par adresse réseau appelante sur une fenêtre de 60 secondes.

Ce compteur général est commun à tous les points d'entrée qui n'ont pas de plafond dédié. Vos appels ici entament donc le même budget que vos appels vers ces autres adresses. Le préfixe /v1 ne crée pas un second budget.

Chaque réponse porte trois en-têtes.

Lisez X-RateLimit-Remaining et ralentissez avant d'atteindre zéro. La valeur de X-RateLimit-Limit peut changer sans préavis, donc n'inscrivez aucun nombre en dur dans votre code.

Ce point d'entrée ne consomme aucun quota de votre offre. Il ne demande ni compte, ni clef d'API, et ne consulte aucune offre.

#Paramètres de chemin et de requête

Aucun. Ce point d'entrée n'a ni paramètre de chemin ni paramètre de requête. Tout passe par le corps de la requête.

#Corps de la requête

Envoyez un objet JSON avec l'en-tête Content-Type: application/json.

Aucun autre champ n'est accepté. Un champ inconnu fait échouer la requête en 422, et aucun champ n'est ignoré en silence.

#Ce que le service nettoie avant de lire

Sur les trois valeurs, le service retire les espaces de début et de fin, ramène les majuscules en minuscules, supprime les deux-points et les espaces internes, puis retire un préfixe 0x s'il en trouve un.

Les deux-points et les espaces sont donc les deux seuls séparateurs tolérés. Tout autre séparateur, tiret ou point, doit être supprimé par vos soins avant l'envoi : un numéro de série écrit 04-1a-2b-3c-4d-5e-6f est refusé en 422.

#C'est la clef publique qui fixe la courbe

Le service déduit la courbe de la longueur de la clef publique de contrôle : 57 octets donnent P-224, 65 octets donnent P-256. Vous n'avez aucun paramètre de courbe à envoyer, et la réponse vous indique la courbe retenue.

La longueur de signature attendue en découle. Une signature de 64 octets contrôlée avec une clef P-224 est refusée en 422, avant tout calcul.

POST https://api.sealtrust.io/v1/originality/read-sig/verify

curl -i -X POST https://api.sealtrust.io/v1/originality/read-sig/verify \
  -H "Content-Type: application/json" \
  -d '{
    "uid_hex": "04000000000000",
    "signature_hex": "0000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000001",
    "public_key_hex": "04b70e0cbd6bb4bf7f321390b94a03c1d356c21122343280d6115c1d21bd376388b5f723fb4c22dfe6cd4375a05a07476444d5819985007e34"
  }'

const response = await fetch(
  "https://api.sealtrust.io/v1/originality/read-sig/verify",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      uid_hex: "04000000000000",
      signature_hex:
        "0000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000001",
      public_key_hex:
        "04b70e0cbd6bb4bf7f321390b94a03c1d356c21122343280d6115c1d21bd376388b5f723fb4c22dfe6cd4375a05a07476444d5819985007e34",
    }),
  },
);

console.log(response.status);
console.log(response.headers.get("X-RateLimit-Remaining"));
console.log(await response.json());

import requests

response = requests.post(
    "https://api.sealtrust.io/v1/originality/read-sig/verify",
    json={
        "uid_hex": "04000000000000",
        "signature_hex": "0000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000001",
        "public_key_hex": "04b70e0cbd6bb4bf7f321390b94a03c1d356c21122343280d6115c1d21bd376388b5f723fb4c22dfe6cd4375a05a07476444d5819985007e34",
    },
    timeout=30,
)

print(response.status_code)
print(response.headers["X-RateLimit-Remaining"])
print(response.json())

{
  "valid": false,
  "curve": "secp224r1",
  "uid_hex": "04000000000000",
  "signature_hex": "0000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000001",
  "error": "signature invalide",
  "public_key_used": "04b70e0cbd6bb4bf7f321390b94a03c1d356c21122343280d6115c1d21bd376388b5f723fb4c22dfe6cd4375a05a07476444d5819985007e34"
}