Transfers

Descripción general de Transfers

Conoce la superficie de la API de Transfers, sus convenciones de respuesta y el catálogo de endpoints.

Compartir

Conoce la superficie de la API de Transfers, sus convenciones de respuesta y el catálogo de endpoints.

Ruta base

Todas las operaciones viven bajo /v1/transfers y requieren credenciales de API.

text
text
https://api.sandbox.travelandz.com/v1/transfers

Tipos de contenido

Envía Content-Type: application/json en cualquier petición con body. Los endpoints de stream requieren Accept: text/event-stream.

Códigos de éxito

OperaciónHTTP
Consultas200 OK
Pricing200 OK
Booking y cambios200 OK
Cancelación200 OK
Conexión de stream establecida200 OK

Crear una reserva responde 200, no 201. La respuesta incluye un campo status, porque una reserva no siempre queda confirmada en el momento en que la petición retorna. Consulta [Reservar un transfer](/docs/transfers-book) para los tres estados que debes manejar.

Las propiedades desconocidas en un body o una query se rechazan con 400.

Catálogo de endpoints

MethodPathPurpose
POST/v1/transfers/searchSearch transfer offers.
GET/v1/transfers/amenitiesList the amenity catalog.
POST/v1/transfers/pricingConfirm the final price of an offer.
POST/v1/transfers/bookCreate a reservation.
GET/v1/transfers/reservations/detailsRead a reservation by any identifier.
GET/v1/transfers/reservations/by-confirmation/:confirmationNumberRead a reservation by confirmation number.
GET/v1/transfers/reservations/by-search/:searchIdRead a reservation by search ID.
GET/v1/transfers/reservations/:reservationIdRead a single reservation.
POST/v1/transfers/reservations/changes/searchSearch replacement offers.
POST/v1/transfers/reservations/changesConfirm a reservation change.
POST/v1/transfers/flights/verifyCheck a flight against the pickup time.
GET/v1/transfers/flightsLook up a flight.
GET/v1/transfers/reservations/:reservationId/vehicleRead driver and vehicle.
GET/v1/transfers/reservations/:reservationId/vehicle/streamStream driver and vehicle.
GET/v1/transfers/tracking/:reservationId/events/latestRead the latest tracking event.
GET/v1/transfers/tracking/:reservationId/events/streamStream tracking events.
DELETE/v1/transfers/reservations/:reservationIdCancel a reservation.

Checklist de integración

  1. Persiste searchId, resultId, bookingToken, pricingToken, reservationId, confirmationNumber y tu propio partnerTrackingId.
  2. Cobra únicamente el finalPrice.amount devuelto por pricing.
  3. Nunca recompongas un precio desde una respuesta de búsqueda ni desde los datos de amenities.
  4. Trata 409 transfer_price_changed como una nueva cotización obligatoria.
  5. Trata 502 como una petición fallida y consulta la reserva antes de crear otra.
  6. Consulta por searchId las reservas que incluyen amenities.
  7. Reintenta 429 y los fallos temporales de red con backoff exponencial.
  8. Cierra explícitamente las conexiones de stream cuando ya no las necesites.
  9. Nunca registres tokens, datos de pago ni datos personales del viajero en el cliente.