Build with Dhuveli

GET/vessels

All your active vessels, each with its latest position.

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     https://dhuveli.com/api/v1/vessels

Response

{
  "data": [
    {
      "id": 12,
      "name": "Ocean Queen",
      "type": "Dhoani",
      "capacity": 40,
      "state": { "key": "moving", "label": "Moving" },
      "position": {
        "lat": 3.947643,
        "lng": 73.486898,
        "fixTime": "2026-06-17T16:34:18+00:00",
        "speed": { "knots": 9.2, "kmh": 17.0 },
        "course": { "degrees": 163, "cardinal": "SSE" },
        "power": { "volts": 12.2, "on": true, "hasData": true }
      }
    }
  ]
}

position is null and state.key is "unknown" when a vessel has no recorded fixes.

GET/vessels/{id}/track

The most recent activity for one vessel, newest first: up to the last 30 positions and the last 10 events (each with its time). No query parameters.

curl -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     "https://dhuveli.com/api/v1/vessels/12/track"

Response

{
  "vessel": { "id": 12, "name": "Ocean Queen" },
  "positions": [
    {
      "lat": 3.947643,
      "lng": 73.486898,
      "speed": { "knots": 9.2, "kmh": 17.0 },
      "course": { "degrees": 163, "cardinal": "SSE" },
      "fixTime": "2026-06-17T16:34:18+00:00"
    }
  ],
  "events": [
    {
      "type": "deviceMoving",
      "time": "2026-06-17T16:30:02+00:00",
      "attributes": null
    }
  ]
}

GET/links

Your share links and the vessels currently on each.

{
  "data": [
    {
      "code": "sunset-ferry",
      "url": "https://dhuveli.com/l/sunset-ferry",
      "active": true,
      "expires_at": null,
      "vessels": [ { "id": 12, "name": "Ocean Queen" } ]
    }
  ]
}

POST/links

Create a temporary share link. An expiry is required — links created through the API always expire. Requires the manage-links ability.

curl -X POST \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"vessel_ids": [12, 15], "expires_at": "2026-06-18T17:00:00Z"}' \
     https://dhuveli.com/api/v1/links

Response (201 Created)

{
  "code": "a1b2c3d4",
  "url": "https://dhuveli.com/l/a1b2c3d4",
  "active": true,
  "expires_at": "2026-06-18T17:00:00+00:00",
  "vessels": [
    { "id": 12, "name": "Ocean Queen" },
    { "id": 15, "name": "Reef Runner" }
  ]
}

PUT/links/{code}/vessels

Replace which vessels are shown on a link. {code} is the link's slug (the part after /l/). Requires the manage-links ability.

curl -X PUT \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"vessel_ids": [12, 15]}' \
     https://dhuveli.com/api/v1/links/sunset-ferry/vessels

Response

{
  "code": "sunset-ferry",
  "url": "https://dhuveli.com/l/sunset-ferry",
  "active": true,
  "expires_at": "2026-07-01T00:00:00+00:00",
  "vessels": [
    { "id": 12, "name": "Ocean Queen" },
    { "id": 15, "name": "Reef Runner" }
  ]
}

Create the link itself (and its {code}) once in the dashboard under Shared Links; this endpoint then drives which vessels it shows.

PATCH/links/{code}

Update an existing link. Send any of the fields below (at least one required). Requires the manage-links ability, and you can only update your own links.

curl -X PATCH \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"expires_at": "2026-07-01T00:00:00Z", "active": false}' \
     https://dhuveli.com/api/v1/links/sunset-ferry

Response — the updated link (same shape as POST /links).

DELETE/links/{code}

Permanently delete one of your links — the public /l/{code} page stops working immediately. Requires the manage-links ability, and you can only delete your own links.

curl -X DELETE \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Accept: application/json" \
     https://dhuveli.com/api/v1/links/sunset-ferry

Response

{ "code": "sunset-ferry", "deleted": true }

GET/webhooks

List your endpoints (secrets are never returned). Requires manage-webhooks.

POST/webhooks

Register an endpoint. The signing secret is returned once. Omit event_types (or send an empty array) to receive every event.

curl -X POST \
     -H "Authorization: Bearer YOUR_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{"url": "https://your-app.com/webhooks/dhuveli", "description": "Production", "event_types": ["vessel.geofence_enter", "vessel.overspeed"]}' \
     https://dhuveli.com/api/v1/webhooks

Response (201 Created)

{
  "id": 3,
  "url": "https://your-app.com/webhooks/dhuveli",
  "description": "Production",
  "event_types": [ "vessel.geofence_enter", "vessel.overspeed" ],
  "active": true,
  "secret": "whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"
}

PATCH/webhooks/{id}  ·  DELETE/webhooks/{id}

Update (url, description, event_types, active) or delete an endpoint. Setting active: true also clears the auto-disable.

POST/webhooks/{id}/test

Queue a webhook.test ping to the endpoint so you can confirm signature verification end-to-end.