Saltar al contenido principal
Instale el paquete público:
Use Node.js 18 o posterior. Los recursos principales son issuers, keys, attestations, verify, audit y receipts. No asuma que cada API pública tiene un método de conveniencia en este paquete; use la referencia de operación y client.request cuando sea apropiado.

Configurar autenticación

La estrategia de clave API es service, no apiKey. Para una operación de usuario, use auth: { type: 'bearer', token } con un token de usuario válido. tenantId no autentica ni cambia de espacio de trabajo. No use autenticación solo de inquilino.

Acuñar

Utilice un emisor existente y una clave disponible para la firma del lado del servidor. Utilice bytes originales codificados o entrada estructurada schema y claims.
Establezca las tres variables de entorno antes de ejecutar el fragmento. Para entrada estructurada, reemplace payload_b64url con schema: "attestation" y claims: { subject: "demo-record" }; nunca envíe ambos modos. El registro de clave pública por sí solo no aprovisiona una clave privada de firma.

Reintentos y manejo de respuestas

El cliente agrega un encabezado de idempotencia a las solicitudes POST y PUT. Una nueva llamada de método genera una nueva clave, por lo que no es un reintento seguro de una escritura anterior incierta a menos que conserve y pase la misma clave. client.request acepta una opción idempotencyKey. Los reintentos automáticos se limitan a lecturas y escrituras de atestación/recibo compatibles con una clave explícita; las escrituras arbitrarias no se reproducen simplemente porque se proporcionó una clave. Inspeccione la verificación verdict y reasons. Una promesa resuelta o un HTTP 200 por sí solos no son un resultado de verificación válido. Haga coincidir la versión del paquete instalado con sus declaraciones de tipo; el código fuente recién corregido no es evidencia de que una versión instalada anterior contenga las correcciones. Consulte el ejemplo HTTP directo para una integración independiente de dependencias y la referencia de API para el contrato actual.