FellaHost Company Limited

Project Developers & Software Engineering Specialists

Document Reference: Section 24 Deliverables for Software Development Team

System Designation: Integrated Clearing, Forwarding & Logistics System (ICFLS)

Corporate Entity: FellaHost Company Limited

Headquarters: P.O. Box 80079, Dar es Salaam, Tanzania

6. Internal & External API Specification (OpenAPI 3.1)

Executive Overview

The ICFLS API provides RESTful endpoints on https://api.domain.co.tz for customer tracking portals, telematics GPS hardware ingestion, TRA TANCIS customs integration, and corporate accounting synchronization.

6.1 Authentication & Security Architecture

• Standard: Bearer Token Authentication via Laravel Sanctum (OAuth2 compliant).
• Transport: TLS 1.3 encryption required on all requests.
• Rate Limiting: 60 requests/minute for standard tier; 1,000 requests/minute for internal telemetry pipelines.

6.2 Key Endpoint Specifications

6.2.1 Real-Time Consignment Tracking

• Endpoint: GET /api/v1/track/{reference}
• Authentication: Public (Rate-limited to 30 req/min per IP)
• Response Format (JSON):

{
  "status": "success",
  "data": {
    "job_number": "ICFLS-2026-0941",
    "tracking_ref": "MEDU9918234",
    "customer": "Mega Mining Corporation Ltd",
    "cargo": "Heavy Mining Extraction Machinery",
    "status": "In_Transit",
    "current_stage": "En Route to Tunduma Border",
    "milestones": [
      {
        "stage": "Vessel Discharged",
        "location": "Dar es Salaam Port Berth 4",
        "completed_at": "2026-09-24T10:14:00Z"
      },
      {
        "stage": "Customs Release",
        "location": "TRA TANCIS Desk",
        "completed_at": "2026-09-26T16:30:00Z"
      },
      {
        "stage": "Corridor Haulage Dispatched",
        "location": "Dar es Salaam Depot",
        "completed_at": "2026-09-27T08:00:00Z"
      }
    ],
    "telemetry": {
      "latitude": -8.9142,
      "longitude": 33.4521,
      "speed_kmh": 58,
      "last_ping": "2026-09-29T08:45:00Z"
    }
  }
}

6.2.2 GPS Telematics Telemetry Ingestion

• Endpoint: POST /api/v1/trips/{trip_number}/telemetry
• Authentication: Bearer Token (Fleet Telematics Scope)
• Payload:

{
  "latitude": -8.914210,
  "longitude": 33.452140,
  "speed_kmh": 58.5,
  "heading": "SW",
  "engine_status": "Running",
  "fuel_level_percent": 74.2,
  "recorded_at": "2026-09-29T08:45:00Z"
}

Regulatory Notice

We're Top leading Company Registering under Commercial & Technical ICT Services TIN NO: 189-723-717

FellaHost Company Limited — Project Developers & Engineering Specialists.

Confidential & Proprietary Enterprise Asset — All Rights Reserved.