> For the complete documentation index, see [llms.txt](https://firma-seguro.gitbook.io/guia-usuario/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://firma-seguro.gitbook.io/guia-usuario/api/guia-firma-seguro-api.md).

# Guia Firma Seguro API

**Integra firma digital en tus sistemas con nuestra API REST.**

{% hint style="success" %}
**Cuenta demo gratuita, documentación clara y soporte técnico.** Empieza a integrar en minutos.
{% endhint %}

## Comienza en 3 pasos

{% stepper %}
{% step %}

### Crea tu cuenta demo

Regístrate gratis y obtén acceso inmediato con credenciales de prueba.

[Crear cuenta demo →](https://firmaseguro.co/onboarding/)
{% endstep %}

{% step %}

### Autentica tu API

Configura tus credenciales y aprende los tipos de autenticación disponibles.

[Ver autenticación →](#autenticacion)
{% endstep %}

{% step %}

### Crea tu primer proceso

Envía documentos a firmar vía API con nuestros endpoints.

[Ver documentación →](#versiones)
{% endstep %}
{% endstepper %}

## Documentación por versión

{% tabs %}
{% tab title="API v2.0 (Recomendada)" %}

### La versión más reciente y eficiente

**¿Qué encontrarás?**

* **Crear proceso de firma v2** - Endpoint optimizado para crear procesos
* **Estrategia Callback** - Obtén el documento firmado automáticamente cuando se complete
* **Mejor rendimiento** - Respuestas más rápidas y menor consumo de recursos

{% hint style="info" %}
💡 **Recomendado:** Usa la estrategia Callback para evitar consultas repetitivas y recibir notificaciones automáticas cuando el documento esté firmado.
{% endhint %}
{% endtab %}

{% tab title="API v1.0" %}

### Versión anterior - Aún soportada

**¿Qué encontrarás?**

* **Crear proceso de firma** - Endpoint básico para crear procesos
* **Estrategia Pooling** - Consulta el estado del documento periódicamente
* **Documentación completa** - Todos los endpoints disponibles

{% hint style="warning" %}
⚠️ **Nota:** La estrategia Pooling requiere consultas repetitivas. Considera migrar a v2.0 con Callback para mejor eficiencia.
{% endhint %}
{% endtab %}
{% endtabs %}

## Autenticación

### Autenticación básica en API

Todos los endpoints requieren autenticación. Aprende a configurar tus credenciales:

**Tipos de autenticación:**

* **API Key** - Autenticación mediante headers
* **Bearer Token** - Tokens JWT para mayor seguridad
* **Basic Auth** - Autenticación básica HTTP

{% hint style="info" %}
🔒 **Seguridad:** Nunca compartas tus credenciales. Usa variables de entorno en producción.
{% endhint %}

## Recursos rápidos

### Guía Rápida

* Crear cuenta demo
* Obtener credenciales
* Primer request exitoso
* Ejemplos de código

### Flujos de Trabajo

* Crear proceso de firma
* Estrategia Callback (v2)
* Estrategia Pooling (v1)
* Webhooks y notificaciones

### Referencia

* Glosario de términos
* Códigos de error
* Límites de rate
* Estados de proceso

### Herramientas

* Postman Collection
* SDKs disponibles
* Sandbox de pruebas
* Logs y debugging

{% hint style="info" %}
💬 **¿Necesitas ayuda con la integración?**

* **Tutoriales:** [Canal de YouTube](https://www.youtube.com/channel/UCYvo2P8emAsSHqiEiUopsPg)
* En la esquina inferior izquierda puedes acceder a Soporte tecnico de manera inmediata
  {% endhint %}