§ Desarrolladores

Integre la firma, el sello y el sellado de tiempo con unas pocas líneas de código.

Una API REST de comportamiento predecible, una documentación completa y ejemplos en los principales lenguajes.

§ 01 — Inicio rápido

Su primer documento sellado en tres pasos.

01

Obtenga su clave API

Cree una cuenta y genere una clave desde su espacio. Guárdela en el servidor, en una variable de entorno: nunca debe aparecer en el código que se ejecuta en el navegador.

export DOCACERT_API_KEY="su-clave-de-prueba"

02

Envíe su primer documento

Envíe el archivo y las opciones que necesite. La respuesta contiene el identificador de la operación y el estado del documento.

cURL

curl https://api.docacert.com/v1/seals \
  -H "Authorization: Bearer $DOCACERT_API_KEY" \
  -F "file=@factura-2026-0418.pdf" \
  -F "timestamp=true"

Node.js

import { openAsBlob } from "node:fs";

const form = new FormData();
form.append("file", await openAsBlob("factura-2026-0418.pdf"), "factura-2026-0418.pdf");
form.append("timestamp", "true");

const res = await fetch("https://api.docacert.com/v1/seals", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.DOCACERT_API_KEY}` },
  body: form,
});
const seal = await res.json();

Python

import os
import requests

with open("factura-2026-0418.pdf", "rb") as f:
    res = requests.post(
        "https://api.docacert.com/v1/seals",
        headers={"Authorization": f"Bearer {os.environ['DOCACERT_API_KEY']}"},
        files={"file": f},
        data={"timestamp": "true"},
    )

seal = res.json()

C#

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("DOCACERT_API_KEY"));

using var form = new MultipartFormDataContent
{
    { new StreamContent(File.OpenRead("factura-2026-0418.pdf")), "file", "factura-2026-0418.pdf" },
    { new StringContent("true"), "timestamp" }
};

var res = await http.PostAsync("https://api.docacert.com/v1/seals", form);
var seal = await res.Content.ReadFromJsonAsync<Seal>();

Respuesta · 201

{
  "id": "seal_8f2c41d0e7",
  "status": "sealed",
  "format": "PAdES-B-LT",
  "timestamp": "2026-10-13T09:41:27Z",
  "sha256": "9b1f04…a2c07e"
}

03

Siga el resultado

Descargue el documento certificado o suscríbase a los webhooks para recibir un aviso en cada etapa. Compruebe siempre la firma de las notificaciones recibidas.

{
  "type": "seal.completed",
  "created_at": "2026-10-13T09:41:29Z",
  "data": {
    "id": "seal_8f2c41d0e7",
    "status": "sealed"
  }
}

§ 02 — Principios de la API

Convenciones que ya conoce.

REST y JSON

Recursos con nombres claros, verbos HTTP estándar y respuestas en JSON.

Especificación OpenAPI

Genere su cliente o importe la API en sus herramientas a partir de la especificación pública.

Entorno de pruebas

Desarrolle y pruebe con una clave dedicada, aislada de producción.

Webhooks firmados

Cada notificación está firmada: compruebe su autenticidad antes de procesarla.

Errores explícitos

Códigos HTTP coherentes y mensajes de error detallados para corregir rápidamente.

Registro de auditoría

Cada operación queda registrada y es exportable, para sus controles internos y para sus auditores.

§ 03 — Recursos

Todo lo necesario para una integración sin sorpresas.

Documentación

Guías, conceptos y buenas prácticas, desde la primera llamada hasta la puesta en producción.

Referencia de la API

Cada endpoint, sus parámetros y sus respuestas, con ejemplos.

Soporte técnico

¿Una pregunta sobre su integración? Escriba a nuestro equipo técnico.

§ Empezar

¿Listo para enviar su primer documento?

Obtenga su clave API y realice sus primeras llamadas en el entorno de pruebas.