curl --request POST \
--url https://api.truthlocks.com/v1/attestations/mint \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"kid": "es256-key-1",
"schema": "verifiable-id",
"claims": {
"full_name": "Example recipient",
"employee_id": "QA-001"
}
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
issuer_id: '550e8400-e29b-41d4-a716-446655440000',
kid: 'es256-key-1',
schema: 'verifiable-id',
claims: {full_name: 'Example recipient', employee_id: 'QA-001'}
})
};
fetch('https://api.truthlocks.com/v1/attestations/mint', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/attestations/mint"
payload = {
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"kid": "es256-key-1",
"schema": "verifiable-id",
"claims": {
"full_name": "Example recipient",
"employee_id": "QA-001"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/attestations/mint"
payload := strings.NewReader("{\n \"issuer_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"kid\": \"es256-key-1\",\n \"schema\": \"verifiable-id\",\n \"claims\": {\n \"full_name\": \"Example recipient\",\n \"employee_id\": \"QA-001\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"issuer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>",
"status": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"log": {
"log_id": "<string>",
"leaf_index": 123,
"status": "recorded",
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"governance": {}
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "PAYLOAD_TOO_LARGE",
"message": "Request body exceeds maximum size of 1MB",
"http_status": 413
}{
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded",
"http_status": 429,
"retry_after_ms": 60000
}Emitir una atestación
Acuñe una atestación firmada utilizando un esquema y reclamaciones estructurados, o una carga útil codificada. Conserve la misma Idempotency-Key y cuerpo al reintentar esta solicitud.
curl --request POST \
--url https://api.truthlocks.com/v1/attestations/mint \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-API-Key: <api-key>' \
--data '
{
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"kid": "es256-key-1",
"schema": "verifiable-id",
"claims": {
"full_name": "Example recipient",
"employee_id": "QA-001"
}
}
'const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
'X-API-Key': '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
issuer_id: '550e8400-e29b-41d4-a716-446655440000',
kid: 'es256-key-1',
schema: 'verifiable-id',
claims: {full_name: 'Example recipient', employee_id: 'QA-001'}
})
};
fetch('https://api.truthlocks.com/v1/attestations/mint', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/attestations/mint"
payload = {
"issuer_id": "550e8400-e29b-41d4-a716-446655440000",
"kid": "es256-key-1",
"schema": "verifiable-id",
"claims": {
"full_name": "Example recipient",
"employee_id": "QA-001"
}
}
headers = {
"Idempotency-Key": "<idempotency-key>",
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/attestations/mint"
payload := strings.NewReader("{\n \"issuer_id\": \"550e8400-e29b-41d4-a716-446655440000\",\n \"kid\": \"es256-key-1\",\n \"schema\": \"verifiable-id\",\n \"claims\": {\n \"full_name\": \"Example recipient\",\n \"employee_id\": \"QA-001\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"attestation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"issuer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"version": "<string>",
"status": "<string>",
"expires_at_unix": 123,
"issued_at_unix": 123,
"payload_hash": "<string>",
"signature": {
"alg": "<string>",
"kid": "<string>",
"value": "<string>"
},
"log": {
"log_id": "<string>",
"leaf_index": 123,
"status": "recorded",
"leaf_hash": "<string>",
"proof_url": "<string>"
},
"governance": {}
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}{
"code": "PAYLOAD_TOO_LARGE",
"message": "Request body exceeds maximum size of 1MB",
"http_status": 413
}{
"code": "RATE_LIMIT_EXCEEDED",
"message": "Rate limit exceeded",
"http_status": 429,
"retry_after_ms": 60000
}Elegir un tipo de registro
Para un registro estructurado, elijaschema del menú desplegable de tipo de registro e introduzca un objeto JSON en claims. Deje payload_b64url vacío. El servidor serializa estos campos en la carga JSON firmada. Esto identifica el tipo de registro; no establece de forma independiente que las afirmaciones sean verdaderas.
Elegir un paquete de verificación
Los paquetes de verificación pertenecen a su espacio de trabajo. Utilice el selector a continuación con el mismo entorno y clave API que Probar, luego copie el ID seleccionado enpack_id. Omita ese campo para un registro independiente. También puede usar Listar paquetes de verificación o Crear en Console.
Usar una carga útil existente
Si ya tiene los bytes exactos para firmar, omitaschema y claims. Codifique los bytes originales como base64url sin relleno en payload_b64url. Para JSON, serialice el objeto primero. Los campos de aplicación como subject, claims y schema pertenecen a esos bytes codificados; utilícelos a través de la entrada estructurada anterior o dentro de los bytes codificados, nunca ambos. Este endpoint no verifica de forma independiente la veracidad de las afirmaciones enviadas ni valida esquemas de credenciales arbitrarios.
Utilice el kid de la clave y el alg correspondiente. El registro de clave pública por sí solo no hace que una clave de firma privada esté disponible. Consulte claves de emisor.
Caducidad opcional
Paraschema y claims estructurados, establezca expires_at_unix en una marca de tiempo Unix futura en segundos. Truthlocks lo incluye en la raíz de la carga JSON firmada. Con payload_b64url, coloque este campo dentro de la carga JSON exacta antes de codificarlo y omita el campo de solicitud separado.
Después de ese instante, la verificación devuelve EXPIRED. La caducidad no se puede extender ni eliminar de un registro firmado existente; cree un reemplazo. Omítala cuando no desee una caducidad de atestación. Las fechas dentro de reclamaciones individuales, como el expiry_date de un pasaporte, son reclamaciones separadas y no establecen automáticamente la caducidad de la atestación. A los registros existentes no se les asigna una fecha retrospectivamente.
Conserve la carga útil y la caducidad exactas al reintentar. Un reintento idempotente devuelve el registro original incluso después de su caducidad.
Reintentar de forma segura
Idempotency-Key es obligatorio. Genere un valor por acuñación prevista y consérvelo con la solicitud original para reintentos. No lo reutilice para contenido diferente.
Integridad del documento
El hash del documento almacenado se selecciona en este orden:claims.document.sha256dentro de una carga útil JSON.- El
document_hashde la solicitud. - SHA-256 de los bytes de la carga útil decodificada.
document_hash_hex a verification para comparar un hash de archivo. Conserve la carga útil original para la verificación de la integridad de la carga útil.
Respuesta y entrega
HTTP 201 devuelveattestation_id, issued_at_unix, signature y log. La posición del registro es log.leaf_index, no un log_index de nivel superior.
recipient_email solicita notificación asíncrona. HTTP 201 confirma la acuñación, no la entrega del correo electrónico. Omítalo cuando distribuya el registro usted mismo.
Consulte el inicio rápido para una solicitud que utiliza los campos de entrada y respuesta reales.
Guía de campos de tipo de registro
Estos campos son estructuras de reclamación sugeridas, no una garantía de validación de reclamación o verificación de identidad.| ID de esquema | Nombre | Categoría | Campos de reclamación |
|---|---|---|---|
verifiable-id | Identificación Verificable | Identidad | full_name, employee_id, department, title, start_date |
passport | Pasaporte | Identidad | full_name, nationality, passport_number, date_of_birth, expiry_date, issuing_country |
drivers-license | Licencia de Conducir | Identidad | full_name, license_number, state, class, expiry_date, date_of_birth |
government-id | Identificación Gubernamental | Identidad | full_name, id_number, id_type, issuing_authority, country, expiry_date |
self-sovereign-id | Identificación Auto-Soberana | Identidad | did, display_name, created_at |
employment-verification | Verificación de Empleo | Empleo | employee_name, employer, position, department, employment_type, start_date, end_date |
professional-role | Rol Profesional | Empleo | full_name, title, organization, department, effective_date |
membership-card | Tarjeta de Membresía | Empleo | member_name, organization, membership_id, tier, valid_from, valid_to |
professional-certification | Certificación profesional | Empleo | holder_name, certification_name, issuing_body, certification_id, issued_date, expiry_date |
license | Licencia | Empleo | holder_name, license_type, license_number, issuing_authority, jurisdiction, issued_date, expiry_date |
accreditation | Acreditación | Empleo | entity_name, accreditation_body, standard, scope, valid_from, valid_to |
degree | Título | Educación | student_name, institution, degree_type, field_of_study, graduation_date, honors |
completion-cert | Certificado de Finalización | Educación | participant_name, program_name, institution, completion_date, hours |
course-credit | Crédito de Curso | Educación | student_name, course_name, institution, credits, grade, semester |
transcript | Expediente Académico | Educación | student_name, institution, program, gpa, total_credits, issue_date |
micro-credential | Micro-Credencial | Educación | earner_name, credential_name, issuer, skills, earned_date |
training-completion | Finalización de Capacitación | Educación | trainee_name, training_program, provider, completion_date, score, certificate_id |
medical-license | Licencia Médica | Salud | practitioner_name, license_number, specialty, state, issued_date, expiry_date |
dea-registration | Registro DEA | Salud | registrant_name, dea_number, schedules, business_activity, expiry_date |
board-certification | Certificación de la Junta | Salud | physician_name, board, specialty, certification_date, expiry_date |
health-credential | Credencial de Salud | Salud | patient_name, credential_type, provider, date, details |
vaccination-record | Registro de Vacunación | Salud | patient_name, vaccine_name, manufacturer, lot_number, date_administered, dose_number, site |
aml-kyc | Verificación AML/KYC | Cumplimiento | entity_name, check_type, result, risk_level, verified_by, verified_at |
security-clearance | Autorización de Seguridad | Cumplimiento | holder_name, clearance_level, granting_agency, granted_date, expiry_date |
sam-gov | Registro SAM.gov | Cumplimiento | entity_name, cage_code, uei, registration_status, expiry_date |
jurisdiction-approval | Aprobación de Jurisdicción | Cumplimiento | entity_name, jurisdiction, approval_type, approved_date, conditions |
attestation-of-will | Atestación de Voluntad | Cumplimiento | declarant_name, declaration, witness, date |
bank-verification | Verificación Bancaria | Financiero | account_holder, bank_name, account_type, routing_number_last4, verified_date |
credit-attestation | Atestación de Crédito | Financiero | entity_name, credit_score_range, reporting_agency, assessment_date |
income-verification | Verificación de Ingresos | Financiero | individual_name, employer, annual_income_range, verification_date, tax_year |
skill-badge | Insignia de Habilidad | Habilidades y Capacitación | earner_name, skill_name, proficiency_level, assessed_by, earned_date |
competency | Atestación de Competencia | Habilidades y Capacitación | individual_name, competency, level, assessor, assessment_date |
industry-cert | Certificación de Industria | Habilidades y Capacitación | holder_name, certification, issuing_body, cert_id, issued_date, expiry_date |
product-authenticity | Autenticidad del Producto | Cadena de Suministro | product_name, sku, serial_number, manufacturer, manufactured_date, origin_country |
chain-of-custody | Cadena de Custodia | Cadena de Suministro | item_description, from_entity, to_entity, transfer_date, location, condition |
origin-verification | Verificación de Origen | Cadena de Suministro | product_name, origin_country, origin_region, certifying_body, verified_date |
custom | Personalizado | Otro | subject, type, details |
attestation | Atestación Genérica | Otro | subject, claim, evidence |
Encabezados
Cuerpo
- Structured record
- Encoded payload
Elija Registro estructurado para seleccionar un tipo de registro e ingresar reclamaciones, o Carga útil codificada para firmar bytes existentes. Nunca combine ambos formatos de entrada.
Tipo de registro para entrada estructurada. Proporcione reclamaciones y omita payload_b64url. Esta etiqueta no valida de forma independiente la veracidad de las reclamaciones.
verifiable-id, passport, drivers-license, government-id, self-sovereign-id, employment-verification, professional-role, membership-card, professional-certification, license, accreditation, degree, completion-cert, course-credit, transcript, micro-credential, training-completion, medical-license, dea-registration, board-certification, health-credential, vaccination-record, aml-kyc, security-clearance, sam-gov, jurisdiction-approval, attestation-of-will, bank-verification, credit-attestation, income-verification, skill-badge, competency, industry-cert, product-authenticity, chain-of-custody, origin-verification, custom, attestation "verifiable-id"
Marca de tiempo Unix futura opcional en segundos para la entrada de esquema/reclamaciones estructuradas. Se incluye en la carga JSON firmada. Para la entrada payload_b64url, omita este campo de solicitud e incruste expires_at_unix en la raíz de la carga JSON exacta. La caducidad no se puede cambiar en su lugar.
1 <= x <= 253402300799Respuesta
Atestación acuñada

