Ir a la referencia
Identik Desarrolladores

Firma Digital

API de Identik

Creá documentos, enviá invitaciones y consultá las firmas desde tu integración. Para nuevos desarrollos, usá v2 estable. Las integraciones v1 siguen disponibles, sin migración obligatoria.

URL base de esta plataforma
https://sandbox-firma.identik.me/api/v2
Autenticación · encabezado HTTP
Authorization: Bearer api_...

Usá un token de esta plataforma y este entorno. El mismo token sirve para v1 y v2; guardalo en tu servidor.

Empezar con v2 PDF, firmantes, envío y resultado
  1. Creá y subí en una sola solicitud. POST /api/v2/document/create recibe multipart/form-data: payload con el JSON y file con el PDF. La respuesta incluye id y envelopeId; usá el id numérico como documentId.
  2. Definí los firmantes y sus campos. Podés incluir recipients y sus fields al crear. Los campos usan coordenadas porcentuales: pageX, pageY, width y height, con pageNumber desde 1. Cada firmante necesita su CUIL correcto antes del envío.
  3. Enviá a firmar. POST /api/v2/document/distribute con documentId. Para distribuir vos los enlaces, configurá meta.distributionMethod: "NONE". Esto desactiva las notificaciones a destinatarios; los avisos al propietario se controlan por separado en meta.emailSettings. Pedí includeSigningUrls: true para recibirlos; tratá cada enlace como un dato privado.
  4. Esperá la finalización. Consultá GET /api/v2/document/{documentId} o recibí el webhook DOCUMENT_COMPLETED. Descargá el resultado final cuando el documento esté COMPLETED: una firma local registrada no confirma por sí sola que terminó el proceso digital.
  5. Descargá los archivos. GET /api/v2/document/{documentId}/download devuelve el PDF directamente. GET /api/v2/document/{documentId}/certificate devuelve la constancia en otro PDF. Para archivar un documento firmado, esperá COMPLETED; en DRAFT o PENDING, la constancia responde 409.

La referencia de abajo incluye los esquemas y ejemplos del contrato v2 estable.

Integraciones v1 Contrato existente y diferencias con v2

Elegí v1 — estable en el selector de la referencia para ver sus endpoints y esquemas.

  1. POST /api/v1/documents crea el documento con JSON. Subí después el PDF con un PUT binario a la uploadUrl recibida.
  2. Agregá campos en POST /api/v1/documents/{documentId}/fields. En v1, el tamaño usa pageWidth y pageHeight.
  3. Enviá con POST /api/v1/documents/{documentId}/send. sendEmail: false permite distribuir vos las invitaciones.
  4. Consultá GET /api/v1/documents/{documentId}. Con el documento COMPLETED, GET /api/v1/documents/{documentId}/download devuelve JSON con la downloadUrl.

v2 tiene otros formatos de solicitud y respuesta: cambiar solamente el prefijo de la URL no alcanza para migrar.

Eventos, errores y archivos de referencia

Configurá los webhooks en la plataforma y verificá el encabezado X-Identik-Secret antes de procesarlos. Usá DOCUMENT_COMPLETED para detectar el documento final.

Ante un 401, revisá el token y la cuenta. Un 400 indica una solicitud inválida: revisá el detalle antes de repetirla. Ante un 429, respetá Retry-After. Evitá repetir creaciones o envíos a ciegas si perdiste la respuesta.

La referencia v2 muestra el contrato estable del flujo de documentos y plantillas. El OpenAPI completo también contiene operaciones adicionales; no todas forman parte de ese contrato.

OpenAPI v2 estable OpenAPI v1 OpenAPI v2 completo Colección Postman

En Postman, elegí Import → Link y pegá https://sandbox-firma.identik.me/api/docs/postman.json. Configurá las variables de entorno antes de ejecutar solicitudes.

Referencia de endpoints

Elegí v2 o v1 en el selector de la referencia.