# REST API de Sig.Surf

Fuente: https://sig.surf/es/integrations/rest-api (versión Markdown de la página)

Una API JSON para crear firmas y gestionar empleados, con una descripción OpenAPI en una URL estable.

> Las firmas creadas con esta interfaz son para Gmail y Google Workspace.

## Qué puedes hacer

- `POST /api/v1/signatures` sin credenciales recibe un id de plantilla o un documento de firma, más los valores de los campos, y devuelve el HTML generado, texto sin formato, advertencias y un enlace de reclamación. Alguien inicia sesión más tarde y la reclama; las firmas sin reclamar caducan a los 30 días.
- Con una clave de API, lista y actualiza los empleados de tu organización.
- Lista el catálogo de plantillas.

## Convenciones

- JSON de entrada y de salida. Los errores tienen la forma `{ "error": { "code", "message" } }` con el código de estado HTTP correspondiente.
- Las claves de API empiezan por `ssk_`, actúan en nombre de una sola organización y se envían como token bearer. De cada clave solo se guarda un hash.
- Los cuerpos de las solicitudes están limitados a 64 KiB. Las llamadas anónimas tienen un límite de frecuencia, y recibes un `429` con una cabecera `Retry-After`.
- El documento OpenAPI 3.1 está en `/api/v1/openapi.json`.

Para los asistentes que hablan MCP, consulta el [servidor MCP](https://sig.surf/es/integrations/mcp-server).
