مرجع Partner API v1

curl "https://api.masardz.com/api/v1/partner/status" -H "Authorization: Bearer $MASAR_API_KEY"

{
  "success": true,
  "data": {
    "items": [{
      "id": 14,
      "plate_number": "12345-116-36",
      "internal_code": "BUS-014",
      "bus_name": "حافلة 14",
      "seats_count": 49,
      "brand": "Example",
      "model": "Coach",
      "year": 2025,
      "current_status": "available",
      "status": "active",
      "current_route_id": 8,
      "last_gps_at": "2026-09-08 10:41:12"
    }],
    "pagination": {"page": 1, "per_page": 25, "total": 1, "total_pages": 1}
  }
}

{
  "success": true,
  "data": {
    "items": [{
      "id": 8,
      "name": "الطارف — عنابة",
      "code": "ETF-ANN",
      "start_name": "الطارف",
      "end_name": "عنابة",
      "distance_estimate": "72.50",
      "duration_estimate": 95,
      "status": "active"
    }],
    "pagination": {"page": 1, "per_page": 25, "total": 1, "total_pages": 1}
  }
}

curl "https://api.masardz.com/api/v1/partner/routes/8/stops" \
  -H "Authorization: Bearer $MASAR_API_KEY"

{
  "success": true,
  "data": {
    "id": 903,
    "route_id": 8,
    "bus_id": 14,
    "trip_date": "2026-09-08",
    "direction": "outbound",
    "planned_departure_at": "2026-09-08 08:00:00",
    "actual_departure_at": "2026-09-08 08:03:00",
    "status": "started",
    "delay_minutes": 3,
    "route_name": "الطارف — عنابة",
    "plate_number": "12345-116-36"
  }
}

{
  "success": true,
  "data": {
    "id": 14,
    "plate_number": "12345-116-36",
    "last_latitude": "36.9001000",
    "last_longitude": "7.7664000",
    "last_gps_at": "2026-09-08 10:41:12",
    "last_speed_kmh": "42.70",
    "last_heading": "81.00",
    "last_accuracy": "6.50"
  }
}