API v1 · Documentación técnica

Integra la firma electrónica en tu producto.

Automatizá el enrolamiento, la verificación de identidad y la firma de documentos desde tu backend. Esta documentación refleja el contrato actual de la API REST.

Quickstart

De cero a una sesión de firma en pocos pasos.

Autenticación

API keys, scopes, entornos y buenas prácticas.

Referencia API

Firmantes, sesiones, schemas, respuestas y estados.

Webhooks

Eventos firmados, reintentos y verificación HMAC.

Primer request

Probá tu API key

Usá una clave `fmr_test_` para validar autenticación y conectividad sin tocar datos de producción.

Sin efectos reales

bashFirmARDigital API

curl https://www.firmardigital.com/api/v1/ping \
  -H "Authorization: Bearer fmr_test_TU_CLAVE"

Contrato base

REST, JSON y respuestas predecibles.

Todas las rutas viven bajo `/api/v1`. Las claves se envían como Bearer token y las operaciones de creación aceptan `Idempotency-Key` para reintentos seguros.

Ver respuestas y errores

Contrato estable

Las respuestas JSON usan siempre `success`. Cuando es `false`, la propiedad `error` incluye un `code` estable para que tu backend tome decisiones sin analizar texto.

Ver catálogo de errores

200

Envelope de éxito

jsonFirmARDigital API

{
  "success": true,
  "data": { "…": "respuesta del recurso" }
}

Ejemplo Node.js

Una integración backend mínima

javascriptFirmARDigital API

const response = await fetch(
  "https://www.firmardigital.com/api/v1/ping",
  { headers: { Authorization: `Bearer ${process.env.FIRMAR_API_KEY}` } }
);

const { data } = await response.json();