Guía de la API

​

Ambientes y base URL

​

Autenticación

curl -X GET "https://api.esolbay.com/api/v1/items/" \
  -H "x-api-key: $ESOLBAY_API_KEY"

const res = await fetch("https://api.esolbay.com/api/v1/orders/", {
  headers: { "x-api-key": process.env.ESOLBAY_API_KEY },
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();

import os, requests
res = requests.get(
  'https://api.esolbay.com/api/v1/providers/',
  headers={'x-api-key': os.environ['ESOLBAY_API_KEY']}
)
res.raise_for_status()
data = res.json()

​

Paginación y ordenado

?limit=20&offset=0&orderBy=createdAt&order=desc

​

Versionado y estabilidad

• Versionado vía prefijo de ruta (/api/v1).
• Cambios incompatibles se publican en versiones mayores.

​

Errores

• 400: solicitud inválida (valida tu payload)
• 401: no autorizado (revisa x-api-key)
• 404: recurso no encontrado
• 500: error interno

​

Webhooks

​

Mejores prácticas

• Almacena x-api-key y secretos en un gestor seguro.
• Implementa idempotencia con x-esolbay-event-id en Webhooks.
• Limita y valida inputs en la integración.