Identik · API para desarrolladores

Autenticación: toda solicitud lleva el encabezado Authorization: Bearer api_.... El token de API te lo entrega Identik; si todavía no tenés el tuyo, contactanos.

Flujo en 6 pasos

El caso típico: subir un PDF, definir firmantes, colocar la firma y descargar el documento firmado. La referencia completa de todos los endpoints está más abajo.

1

Crear el documento

POST/api/v1/documents

Enviás el título y los firmantes (name, email; en la plataforma digital también el cuil). Recibís documentId, uploadUrl (URL de subida) y un signingUrl por firmante.

2

Subir el PDF

PUT{uploadUrl}

Un único lugar de subida: hacés un PUT binario del PDF a la uploadUrl del paso 1. Sin headers extra.

3

Colocar el campo de firma

POST/api/v1/documents/{documentId}/fields

Un campo SIGNATURE por firmante. Coordenadas en porcentaje de la página (pageNumber, pageX, pageY, pageWidth, pageHeight) — la firma queda exactamente ahí en el PDF final.

4

Enviar a firmar

POST/api/v1/documents/{documentId}/send

Con sendEmail: true Identik le manda a cada firmante su enlace único; con false distribuís vos los signingUrl del paso 1.

5

Consultar el estado

GET/api/v1/documents/{documentId}

PENDING hasta que todos firmen, luego COMPLETED. Mejor que hacer polling: configurá un webhook DOCUMENT_COMPLETED.

6

Descargar el PDF firmado

GET/api/v1/documents/{documentId}/download

Devuelve la URL del PDF firmado y sellado, con la constancia de firma (firmantes, marcas temporales, hash SHA-256) integrada al final. Cualquiera puede verificarlo en /validar.

Referencia completa de la API (todos los endpoints, esquemas y ejemplos) 👇