Documentación de la API

Introducción

La API de trycert te permite emitir certificados verificables desde tu propio software. Todas las llamadas se hacen sobre HTTPS a http://www.trycert.com y las respuestas son JSON.

Cada certificado emitido obtiene un identificador único, una URL de verificación pública y un PDF descargable con un código QR que apunta a esa verificación.

Autenticación

Las llamadas a la API se autentican con tu API key, que encuentras en tu panel. Envíala en la cabecera Authorization con el prefijo Bearer:

Authorization: Bearer ck_tu_clave_secreta

Tu clave es secreta: trátala como una contraseña y no la publiques en código de cliente. Si se compromete, puedes regenerarla desde el panel (la anterior dejará de funcionar al instante).

Crear un certificado

POST /v1/certificates

Cuerpo de la petición (JSON):

Ejemplo con curl:

curl -X POST http://www.trycert.com/v1/certificates \
  -H "Authorization: Bearer ck_tu_clave_secreta" \
  -H "Content-Type: application/json" \
  -d '{
    "recipientName": "Ana Lopez",
    "courseName": "Ciberseguridad",
    "issuerName": "Mi Academia",
    "expiresAt": "2027-06-01"
  }'

Respuesta 200 OK:

{
  "id": "a1b2c3d4e5f6",
  "verifyUrl": "http://www.trycert.com/verify/a1b2c3d4e5f6",
  "pdfUrl": "http://www.trycert.com/v1/certificates/a1b2c3d4e5f6/pdf"
}

Listar tus certificados

GET /v1/certificates

Devuelve los certificados de tu cuenta, del más reciente al más antiguo. Requiere tu API key.

curl http://www.trycert.com/v1/certificates \
  -H "Authorization: Bearer ck_tu_clave_secreta"

Respuesta 200 OK:

[
  {
    "id": "a1b2c3d4e5f6",
    "recipientName": "Ana Lopez",
    "courseName": "Ciberseguridad",
    "issuedAt": "2026-06-21T10:30:00Z",
    "verifyUrl": "http://www.trycert.com/verify/a1b2c3d4e5f6",
    "pdfUrl": "http://www.trycert.com/v1/certificates/a1b2c3d4e5f6/pdf"
  }
]

Descargar el PDF

GET /v1/certificates/{id}/pdf

Devuelve el PDF del certificado (application/pdf). Como el identificador es largo e imposible de adivinar, este enlace es público: puedes compartirlo directamente con quien recibe el certificado.

http://www.trycert.com/v1/certificates/a1b2c3d4e5f6/pdf

Verificación pública

GET /verify/{id}

Página pública (HTML, sin API key) donde cualquiera puede comprobar la autenticidad de un certificado. Es la página a la que apunta el código QR del PDF. Muestra tres estados:

Válido · Caducado (si tiene una fecha expiresAt ya pasada) · No encontrado (si el identificador no existe).

Errores