Skip to main content
Documentacion API

Construye con la API de OnFlyGo

Integra servicios OBC directamente en tus sistemas. API RESTful con tracking en tiempo real y documentacion automatizada.

Capacidades de la API

API de Reservas

Crea y gestiona envios OBC programaticamente

API de Tracking

Seguimiento GPS en tiempo real y actualizaciones de estado

API de Documentos

Genera documentacion IATA automaticamente

API de Couriers

Accede a red de couriers verificados y disponibilidad

Autenticacion

Todas las peticiones API requieren autenticacion usando una API key. Incluye tu key en el header Authorization.

curl -X GET "https://api.onflygo.com/v1/shipments" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Endpoints de la API

URL Base: https://api.onflygo.com

POST/v1/shipments
Crear un nuevo envio OBC
{
  "origin": {
    "airport": "MEX",
    "address": "Ciudad de Mexico, Mexico"
  },
  "destination": {
    "airport": "MAD",
    "address": "Madrid, Espana"
  },
  "package": {
    "weight_kg": 5,
    "dimensions": "30x20x15",
    "description": "Partes AOG"
  },
  "urgency": "same_day",
  "pickup_time": "2025-01-15T10:00:00Z"
}
GET/v1/shipments/{id}/tracking
Obtener tracking en tiempo real de un envio
{
  "shipment_id": "SHP-2025-001234",
  "status": "in_transit",
  "current_location": {
    "lat": 19.4326,
    "lng": -99.1332,
    "airport": "MEX",
    "updated_at": "2025-01-15T14:30:00Z"
  },
  "eta": "2025-01-16T08:00:00Z",
  "events": [
    {
      "type": "picked_up",
      "timestamp": "2025-01-15T10:15:00Z",
      "location": "Ciudad de Mexico"
    }
  ]
}
GET/v1/couriers/available
Buscar couriers disponibles para una ruta
{
  "couriers": [
    {
      "id": "COU-001",
      "name": "Juan D.",
      "rating": 4.9,
      "completed_trips": 234,
      "available_from": "2025-01-15T08:00:00Z",
      "airports": ["MEX", "GDL", "MAD", "BCN"]
    }
  ],
  "total": 12
}
POST/v1/documents/generate
Generar documentos de envio
{
  "shipment_id": "SHP-2025-001234",
  "documents": [
    {
      "type": "awb",
      "url": "https://api.onflygo.com/docs/awb-001234.pdf"
    },
    {
      "type": "customs_declaration",
      "url": "https://api.onflygo.com/docs/customs-001234.pdf"
    }
  ]
}

Webhooks

Recibe notificaciones en tiempo real cuando cambia el estado de un envio.

shipment.created
shipment.courier_assigned
shipment.picked_up
shipment.in_transit
shipment.customs_cleared
shipment.delivered

Limites de Peticiones

Las peticiones API tienen limites segun tu plan.

Starter100 peticiones/min
Professional1,000 peticiones/min
EnterpriseIlimitado

SDKs y Librerias

Librerias cliente oficiales para lenguajes populares.

Node.jsProximamente
PythonProximamente
PHPProximamente
GoProximamente
JavaProximamente

¿Listo para integrar?

Contactanos para obtener tus credenciales API y comenzar a construir.