API Documentatie

SchipTrack API Reference

Integreer live scheepvaarttracking in uw eigen systemen. REST API + WebSocket stream + iFrame embed. Base URL: https://skipahoy.nl

Authenticatie

Voeg uw API key toe als HTTP header bij elk verzoek:

Authorization: Bearer st_live_xxxxxxxxxxxxxxxxxxxx

Endpoints

GET/api/v1/vessels
Zoek vaartuig op MMSI of naam
Params: mmsi=string, name=string
GET/api/v1/vessels/:mmsi
Detail + huidige positie van vaartuig
Params: mmsi (path param)
GET/api/v1/vessels/:mmsi/track
Positiegeschiedenis
Params: hours=24 (default)
GET/api/v1/fleet
Haal uw vloot op
Params: -
POST/api/v1/fleet
Voeg vaartuig toe aan vloot
Params: mmsi, alias (optional)
DELETE/api/v1/fleet/:mmsi
Verwijder uit vloot
Params: mmsi (path param)
GET/api/v1/ports/congestion
Havencongestie live
Params: port=RTM|AMS|VLI|ANT
POST/api/v1/webhooks
Registreer webhook voor positie-alerts
Params: url, events[]
WSwss://skipahoy.nl/api/v1/stream
Real-time AIS WebSocket stream
Params: fleet=true OR mmsi[]=...

SDK Voorbeeld

// JavaScript SDK
import SchipTrack from '@schiptrack/sdk';

const client = new SchipTrack({ apiKey: 'st_live_xxxx' });

// Vessel positie ophalen
const vessel = await client.vessels.get('244820000');
console.log(vessel.position); // { lat, lon, speed, course }

// Real-time stream
const stream = client.stream({ fleet: true });
stream.on('position', (update) => {
  console.log(`${update.name}: ${update.lat}, ${update.lon}`);
});

// Fleet beheren
await client.fleet.add({ mmsi: '244820000', alias: 'Mijn schip 1' });
const fleet = await client.fleet.list(); // [{ mmsi, name, position... }]

iFrame Embed

Embed de live kaart direct in uw klantenportaal of website:

<!-- iFrame Embed -->
<iframe 
  src="https://skipahoy.nl/embed/kaart?fleet=true&apiKey=st_live_xxxx"
  width="100%" 
  height="600" 
  frameborder="0"
  allowfullscreen>
</iframe>

<!-- Of via script tag -->
<div id="schiptrack-map" data-api-key="st_live_xxxx" data-fleet="true"></div>
<script src="https://skipahoy.nl/embed.js" async></script>

Rate Limits

Starter (Gratis)
REST: 100 calls/dag
WS: -
Business
REST: 10.000 calls/dag
WS: 10 streams
Enterprise
REST: Onbeperkt
WS: Onbeperkt
White-label
REST: Onbeperkt + SLA
WS: Onbeperkt + dedicated

Klaar om te integreren?

Vraag een API key aan via ons dashboard. Business plan inclusief 10.000 calls/dag.

API Key aanvragen →