Herramientas

Todo lo que te ayuda a probar e integrar la API sin empezar de cero, de Postman e Insomnia a n8n, Make o Zapier.

Postman e Insomnia

Una colección con todos los endpoints de la API, generada del mismo contrato que esta documentación cada vez que se publica el sitio, y dos ambientes:

Colección

Todos los endpoints · Postman v2.1

Ambiente de pruebas

apidev.posdata.so · keys pdk_test_

Ambiente de producción

api.posdata.so · keys pdk_live_

En Postman

Import → arrastra los tres archivos.
Elige el ambiente Posdata · Pruebas (empieza siempre en pruebas, con una key pdk_test_…).
En el ambiente, pon tu API key en la variable api_key. Es de tipo secret: Postman la oculta y no la comparte cuando exportas la colección.
Abre Cuenta → Cuenta, API key y frescura de los datos (GET /me) y envíala: te dice qué cuenta es y qué permisos tiene la key.

Todas las peticiones se autentican con Authorization: Bearer {{api_key}} desde la colección.
Cada POST recibe un Idempotency-Key nuevo ({{$guid}}) de un script de la colección. Para reintentar la misma operación, activa el header Idempotency-Key de esa petición y fija su valor: así no se crea nada dos veces. Mira Idempotencia.
Los cuerpos de ejemplo traen solo los campos obligatorios, con valores ilustrativos: cámbialos por los tuyos. Los filtros de las listas vienen desactivados; actívalos cuando los necesites.

En Insomnia

Insomnia importa la misma colección de Postman: Import → el archivo de la colección. Luego crea un ambiente con las variables base_url (https://apidev.posdata.so/public/v1 para pruebas) y api_key.

Atención

Si tu cliente no ejecuta el script de la colección, agrega a mano el header Idempotency-Key en cada POST (un valor nuevo por operación): sin él la API responde 400 IDEMPOTENCY_KEY_REQUIRED.

Contrato OpenAPI

El contrato completo, en OpenAPI 3.1, está en api.posdata.so/public/v1/openapi.json. Es el mismo del que salen esta documentación y la colección: úsalo para generar un cliente en tu lenguaje o para validar tus integraciones.

Para asistentes de IA

Cada página de esta documentación tiene su versión en Markdown: agrega .md a la dirección (por ejemplo /errores.md). En cada página también están Copiar página y Pregúntale a la IA, que la abre en ChatGPT o Claude.
llms.txt resume la API para un agente en una sola página.
¿Quieres que un agente de IA opere Posdata por ti en vez de integrar tus sistemas? Eso es Agent Connect, disponible en todos los planes: conoce más en posdata.so.

Automatizaciones: n8n, Make y Zapier

No hay una app oficial de Posdata en n8n, Make ni Zapier. No hace falta: la API y los webhooks son HTTP estándar y cada plataforma tiene un paso genérico para ellos.

Plataforma	Para llamar a la API	Para recibir webhooks
n8n	Nodo HTTP Request	Nodo Webhook
Make	Módulo HTTP	Webhooks → webhook personalizado
Zapier	Webhooks by Zapier (Custom Request)	Webhooks by Zapier (Catch Hook)

Para llamar a la API: URL https://api.posdata.so/public/v1/…, header Authorization: Bearer <tu key> (guárdala en las credenciales de la plataforma, no en el texto del paso) y, en cada POST, un Idempotency-Key único por operación: por ejemplo, el id del pedido o de la ejecución.
Para recibir webhooks: crea el endpoint en cuenta.posdata.so → Desarrolladores → Webhooks con la URL que te da la plataforma (solo https en el puerto 443). Verificar la firma exige el cuerpo crudo, byte por byte (mira Webhooks); si tu plataforma no te lo entrega, no actúes solo con el webhook: confírmalo pidiendo el evento con GET /events/{id} y el id que llegó.
Las marcas pertenecen a sus dueños; su mención no implica respaldo.