API
Catálogo, pedidos y claves mediante interfaz
Traiga nuestro catálogo a su sistema, active pedidos y recoja las claves. Esta página muestra el camino en seis pasos. Los límites, el entorno de pruebas y las restricciones están en la documentación.
Esto funcionará en cuanto abra la tienda. Hasta entonces puede leerlo todo con calma.
Página para desarrolladores
OpenAPI
Cada llamada está descrita en un archivo OpenAPI 3.1. Cada cifra de las páginas es la cifra que el código aplica.
- BearerUna clave por aplicación, guardada solo como hash, con caducidad y rotación
- JSONImportes en céntimos enteros, fechas en ISO 8601, nombres en snake_case
- 120 por minutolecturas para una clave nueva, 600 cuando tiene 7 días
- FirmadoWebhooks con firma, y bajo petición también llamadas firmadas (RFC 9421)
La API está construida y probada, la documentación está en línea. Las claves se podrán crear en cuanto abra la tienda. Aún no disponibles y solo planificados: un kit de software ya hecho, un saldo prepagado.
Lo que puede hacer con ella
Sincronizar el catálogo
Cargue la lista completa una vez, después solo lo que ha cambiado desde su última sincronización. Una vista ligera muestra solo las existencias.
Lista, se abre con el inicio de las ventasActivar pedidos
Un pedido por llamada, con límite de precio, su propio número y una clave contra compras duplicadas.
Lista, se abre con el inicio de las ventasRecoger claves
Con un derecho propio, contadas y registradas. La primera consulta pone fin al derecho de desistimiento de ese pedido.
Lista, se abre con el inicio de las ventasRecibir webhooks
Llamadas firmadas a su servidor cuando cambia un pedido o un producto. Hasta 3 direcciones.
Lista, se abre con el inicio de las ventasOfrecer como vendedor
Gestione ofertas, precios y existencias desde su sistema de almacén. Esto requiere que la venta en Capydra esté abierta.
Lista, se abre con el inicio de las ventasUsar con asistentes de IA
La misma cuenta funciona a través de nuestro servidor MCP. Las reglas y los límites son los mismos.
Lista, se abre con el inicio de las ventas
Seis pasos hasta la primera llamada
- 1
Crear una cuenta
Inicia sesión en la tienda.
- 2
Crear una clave
En «Claves API»: un nombre, el rol (comprador o vendedor) y los derechos que necesite. Conceda los mínimos posibles.
- 3
Confirmar la renuncia
Dos frases sobre el desistimiento, una sola vez. Cada pedido hecho con la clave se remite a ellas.
- 4
Proteger la clave
Solo se muestra una vez. Guárdela como una contraseña y añada a la lista las direcciones IP de sus servidores.
- 5
Fijar un límite diario
La suma de todos los pedidos de un día está limitada: €250 para una clave nueva, ajustable hasta €5,000.
- 6
Enviar la primera llamada
Con la clave en la cabecera «Authorization». El ejemplo de abajo lee los primeros productos.
La primera llamada
Una clave empieza por omk_live_. Se incluye en cada llamada como valor Bearer. Los importes se indican en céntimos enteros e incluyen la tarifa de servicio.
curl "https://capydra.com/api/v1/catalog/products?page=1" \
-H "Authorization: Bearer omk_live_YOUR_KEY"
# solo lo que ha cambiado desde su última sincronización
curl "https://capydra.com/api/v1/catalog/products?updatedSince=2026-11-17T00:00:00Z" \
-H "Authorization: Bearer omk_live_YOUR_KEY"Seguir en la documentación
La tienda aún no está abierta: las llamadas que modifican algo responden 403 showcase_mode y las respuestas no incluyen precios.
Preguntas frecuentes
¿Cuánto cuesta la API?
El acceso es gratuito. Usted paga los pedidos que active. No hay cuota fija.
¿Hay un kit de software?
Todavía no. La documentación tiene ejemplos con curl, y el archivo OpenAPI se puede cargar en las herramientas habituales.
¿Cómo consigo límites más altos?
Escríbanos su proyecto y su volumen. Aumentamos los límites para los socios en los que vemos la necesidad.
¿Qué pasa si me roban la clave?
Revóquela en la página de claves y cree una nueva. Hasta entonces, el límite diario y la lista de IP acotan el daño. Las llamadas anómalas bloquean la clave automáticamente.
¿Dónde comunico un error de la API?
A través del formulario de contacto con el tema API. Indique la llamada y la hora.
¿Listo para la primera llamada?
Lea entera la página para desarrolladores y después cree una clave.
Enviar una consulta