Vista previa: Capydra abre pronto. Todavía no es posible hacer pedidos.

Capydra
Plus Ayuda Carrito
Oferta de la semana

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.

Disponible prontoA 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.

Lista, se abre con el inicio de las ventas

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 ventas
  • Activar 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 ventas
  • Recoger 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 ventas
  • Recibir webhooks

    Llamadas firmadas a su servidor cuando cambia un pedido o un producto. Hasta 3 direcciones.

    Lista, se abre con el inicio de las ventas
  • Ofrecer 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 ventas
  • Usar 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. 1

    Crear una cuenta

    Inicia sesión en la tienda.

  2. 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. 3

    Confirmar la renuncia

    Dos frases sobre el desistimiento, una sola vez. Cada pedido hecho con la clave se remite a ellas.

  4. 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. 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. 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

403

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