Qué podés hacer
El API de Integraciones de Drop, en una página.
Este API te permite conectar tu plataforma con Drop: leer el catálogo con precios y existencias, resolver direcciones, crear órdenes y recibir notificaciones cuando cambian de estado.
- Prefijo de todas las rutas:
/integrations/v1 - URL base: una por ambiente, ver Credenciales.
En los ejemplos de esta guía aparece como
{BASE_URL}. - Formato: JSON en peticiones y respuestas. Fechas en ISO 8601 UTC.
- Referencia completa: cada endpoint tiene su página en
Referencia del API, con parámetros, esquemas de respuesta,
códigos de error y ejemplos en curl, JavaScript y Python. El OpenAPI en crudo
está en
/openapi.jsonsi querés generar un cliente desde ahí.
No se puede probar desde el navegador
Cada petición tiene que ir firmada con HMAC (Autenticación) y el navegador no puede calcular la firma por vos. Los ejemplos de la referencia muestran la forma exacta del request; la firma la ponés desde tu código.
Endpoints
| Método y ruta | Permiso | Qué hace |
|---|---|---|
GET /ping | ninguno | Valida tus credenciales y devuelve la hora del servidor |
GET /products | products:read | Tu catálogo paginado; filtros search, vendorId, active |
GET /products/:id | products:read | Un producto con sus variantes |
GET /products/stock | products:read | Existencias en lote, hasta 100 ids |
GET /geo/countries | geo:read | Países disponibles, su moneda y si piden la ubicación del cliente |
GET /geo/states?countryId= | geo:read | Departamentos con sus municipios |
GET /geo/countries/:countryId/address-config | geo:read | Niveles de dirección que exige el país |
GET /couriers?countryId= | geo:read | Todas las paqueterías del país |
GET /couriers/available | geo:read | Solo las que cubren la ruta de una orden concreta |
POST /orders | orders:write | Crea una orden |
GET /orders | orders:read | Tus órdenes, paginadas |
GET /orders/:id | orders:read | Una orden tuya |
PATCH /orders/:id/cancel | orders:write | Cancela una orden tuya antes del despacho |
Más los webhooks salientes: Drop hace un POST a tu endpoint cuando cambia
el estado de una de tus órdenes. Ver Webhooks.