AEGISAEGIS / DevelopersGet API Key
API v1.0

Integra firma digital
en minutos

API REST con autenticación por API key, webhooks para notificaciones en tiempo real, y soporte para NOM-151.

60–3000 req/min
Rate limiting por plan
API Key + Scopes
Auth segura por recurso
Webhooks HMAC
Notificaciones verificadas
OpenAPI 3.1
Spec descargable

Quickstart — tu primer sobre en 5 minutos

1
Obtén tu API key
Ve a Configuración → API & Webhooks → Nueva API key. Guarda la clave — solo la verás una vez.
2
Sube el PDF
POST /v1/documents/upload con tu archivo. Recibirás storage_path y file_hash.
3
Crea el sobre
POST /v1/envelopes con el documento y los firmantes (nombre, email, método de firma).
4
Envía a los firmantes
POST /v1/envelopes/{id}/send — AEGIS envía los emails automáticamente.
5
Escucha el webhook
Recibe envelope.completed cuando todos hayan firmado. Descarga el certificado con GET /v1/envelopes/{id}/certificate.

Endpoints disponibles

POST/api/v1/envelopesCrear sobre
GET/api/v1/envelopesListar sobres
GET/api/v1/envelopes/:idDetalle de sobre
POST/api/v1/envelopes/:id/sendEnviar a firmantes
GET/api/v1/envelopes/:id/certificateCertificado PDF
POST/api/v1/documents/uploadSubir PDF
POST/api/v1/signers/:id/remindReenviar recordatorio
GET/api/v1/usageUso del plan

Ejemplos de código

Flujo completo: subir PDF → crear sobre → enviar a firmantes

cURLNode.jsPythonPHP
# 1. Subir documento
curl -X POST https://aegis.aurum.mx/api/v1/documents/upload \
  -H "Authorization: Bearer aegis_YOUR_KEY" \
  -F "file=@contrato.pdf"

# 2. Crear sobre
curl -X POST https://aegis.aurum.mx/api/v1/envelopes \
  -H "Authorization: Bearer aegis_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Contrato de arrendamiento",
    "documents": [{ "name": "contrato.pdf",
      "storage_path": "STORAGE_PATH_FROM_STEP_1",
      "file_hash": "SHA256_HASH", "file_size": 102400 }],
    "participants": [
      { "name": "Ana García", "email": "ana@ejemplo.com",
        "signature_method": "SIMPLE_PLUS" }
    ]
  }'

# 3. Enviar a firmantes
curl -X POST https://aegis.aurum.mx/api/v1/envelopes/ENVELOPE_ID/send \
  -H "Authorization: Bearer aegis_YOUR_KEY"

Ve la API Reference para el playground interactivo con todos los lenguajes.

Autenticación

Header requerido

Authorization: Bearer aegis_<tu_api_key>

Rate limits por plan

Starter60 req/min
Business300 req/min
Enterprise3000 req/min

Eventos de Webhook

envelope.createdSobre creado
envelope.sentEnviado a firmantes
envelope.completedTodos han firmado
envelope.canceledSobre cancelado
signer.signedUn firmante completó la firma
signer.remindedSe reenvió recordatorio
nom151.certifiedCertificación NOM-151 completada
*Todos los eventos