使用我们的渡轮预订 API 增强您的海事业务

POST /v1/ferries/search
{
  "origin": "PIR",
  "destination": "CHN",
  "date": "2025-07-15",
  "passengers": {
    "adults": 2,
  },
  "vehicle": {
    ...
  }
}

{
  "routes": [{
    "id": "fr_789",
    "departure": "09:30",
    "arrival": "14:45",
    "price": 289.00,
    ...
  }]
}

GET /v1/ferries/routes/fr_789
{
  "options": {
    "cabins": true,
    "meals": true,
    "vehicles": true
  }
}

{
  "cabins": [{
    "type": "outside",
    "deck": 8,
    "price": 120.00
  }],
  "vehicle_spaces": {
    "available": true,
    "price": 89.00
  }
}

POST /v1/ferries/book
{
  "route_id": "fr_789",
  "passengers": [{
    "type": "adult",
    "name": "John Smith",
    "nationality": "GB"
  }],
  "cabin": "outside_8",
  "vehicle": {
    "plate": "AB12 CDE"
  }
}

{
  "booking_id": "BK123",
  "status": "confirmed",
  "ticket_url": "/tickets/123",
  "total": 398.00
}

PATCH /v1/ferries/bookings/BK123
{
  "action": "modify",
  "changes": {
    "sailing_date": "2024-07-16",
    "meal_preference": "vegetarian"
  }
}

{
  "status": "modified",
  "new_booking_id": "BK124",
  "change_fee": 25.00
}