JT808 protocol message

POST /v1/tracker/jt808_message

Process JT808 protocol messages from GPS tracking devices.

No authentication required — this endpoint is open for direct device communication.

This endpoint handles various JT808 message types, including:

• 0100 — Terminal Registration
• 0102 — Terminal Authentication
• 0002 — Terminal Heartbeat
• 0200 — Location Information Report
• 0704 — Positioning Data Batch Upload
• 0003 — Terminal Logout

The hex_data parameter should contain the complete JT808 message in hexadecimal format.

Request

Curl

curl -X POST -H "Content-Type: application/json" -d '{
    "hex_data": "7E0200002C01234567890123456700000000000001040000000027AC7C0114EBC6C70110001E003C0000211013083542007E"
}' "https://api.sportstracklive.com/v1/tracker/jt808_message"

HTTP

POST /v1/tracker/jt808_message HTTP/1.1
Host: api.sportstracklive.com
Content-Type: application/json

{
    "hex_data": "7E0200002C01234567890123456700000000000001040000000027AC7C0114EBC6C70110001E003C0000211013083542007E"
}

Location report response

200 OK — application/json; charset=utf-8

{
    "status": "processed",
    "message_type": "location_report",
    "response_hex": "7E8001000501234567890123450200007E",
    "location_data": {
        "imei": "012345678901",
        "latitude": 39.123456,
        "longitude": 116.987654,
        "altitude": 272,
        "speed": 30.0,
        "direction": 60,
        "device_time": "2021-10-13 08:35:42",
        "client_ip": "192.168.1.100",
        "params": "acc=1|ignition=1|",
        "rapid_acceleration": "0",
        "bird_death": "0",
        "bird_take_off": "0"
    },
    "processing_result": {
        "success": true,
        "message": "Location data processed"
    }
}

Registration response

200 OK — application/json; charset=utf-8

{
    "status": "processed",
    "message_type": "registration",
    "response_hex": "7E8100000801234567890123450000313233343536A67E",
    "terminal_registered": true
}