API REST (OpenAPI)

La API REST pública de Oktopus para crear órdenes de contraentrega y consultar cobertura, con especificación OpenAPI 3.0.

Además del MCP, Oktopus expone una API REST para los flujos agent-facing y de integración directa. La especificación completa, máquina-legible:

https://www.oktopus.lat/openapi.json

Endpoints principales

Endpoint	Qué hace
`POST /api/orders/create`	Crear una orden de contraentrega desde tu propia página (publishable key). Los campos del body van en español (`nombre`, `telefono`, `departamento`, `ciudad`, `direccion`…) — el contrato completo con los campos por país está en el OpenAPI y en Conectá tu propia página.
`GET /api/geo/cities?country=CO`	Ciudades válidas por país (para el campo ciudad del checkout — evita el mismatch comprador↔Dropi). En PY, MX, CO, PA y EC el server además canonicaliza la ciudad contra el catálogo de Dropi al crear la orden.

Publishable key (okto_live_pub_..., o okto_test_pub_... para sandbox) — para el checkout en páginas públicas. Va en el header x-okto-api-key. Solo puede crear órdenes de los productos/dominios autorizados; una key de test crea la orden SIN empujarla a Dropi.
Secret key (okto_live_secret_...) — para operaciones de cuenta vía MCP/REST (Authorization: Bearer ...). Nunca la pongas en una página pública.

¿Tu cliente es un agente? Probablemente quieras el MCP en vez de la REST — el MCP ya trae las 62 tools con sus schemas.