issuers, keys, attestations, verify, audit et receipts. Ne supposez pas que chaque API publique dispose d’une méthode de commodité dans ce package ; utilisez la référence d’opération et client.request le cas échéant.
Configurer l’authentification
service, pas apiKey. Pour une opération utilisateur, utilisez auth: { type: 'bearer', token } avec un jeton utilisateur valide. tenantId n’authentifie pas et ne change pas d’espace de travail. N’utilisez pas l’authentification réservée aux locataires.
Mint
Utilisez un émetteur existant et une clé disponible pour la signature côté serveur. Utilisez soit les octets originaux encodés, soit les entrées structuréesschema et claims.
payload_b64url par schema: "attestation" et claims: { subject: "demo-record" } ; n’envoyez jamais les deux modes. L’enregistrement de la clé publique seule ne provisionne pas de clé privée de signature.
Nouvelles tentatives et gestion des réponses
Le client ajoute un en-tête d’idempotence aux requêtes POST et PUT. Un nouvel appel de méthode génère une nouvelle clé, ce n’est donc pas une nouvelle tentative sûre d’une écriture antérieure incertaine, sauf si vous conservez et transmettez la même clé.client.request accepte une option idempotencyKey. Les nouvelles tentatives automatiques sont limitées aux lectures et aux écritures d’attestation/réception prises en charge avec une clé explicite ; les écritures arbitraires ne sont pas rejouées simplement parce qu’une clé a été fournie.
Inspectez la vérification verdict et reasons. Une promesse résolue ou un code HTTP 200 seul ne constitue pas un résultat de vérification valide. Faites correspondre la version du package installé avec ses déclarations de type ; une source nouvellement corrigée ne prouve pas qu’une version plus ancienne installée contient les correctifs.
Consultez l’exemple HTTP direct pour une intégration indépendante des dépendances et la référence API pour le contrat actuel.
