Ontwikkelaarscentrum - Super Label

REST API Documentatie

Verken, test en integreer met onze RESTful endpoints. Volledige Swagger UI met interactieve request builder en authenticatieondersteuning.

REST API

GraphQL API Documentatie

Vraag precies de gegevens op die u nodig heeft met onze GraphQL API. Interactieve playground met schema-verkenner en operatietests.

GraphQL

MCP-column

AI-agents en MCP-clients: setup, beveiligingsprofielen, goedkeuringen en live tools.

MCP

Integratiehandleidingen

Vier zelfstandige paden. Elk pad is op zichzelf compleet: authenticeren, tarief, boeken, label of betalen, volgen en een testlijst. Blijf op het pad dat u hebt geopend.

Uitgaande verzending

Afhaling en bezorging (eigen vloot)

Een afhaal- of bezorgorder aanmaken, het lokale etiket printen, volgen en gebeurtenissen ontvangen — eigen vloot, van begin tot eind. Een tariefopvraag is optioneel.

Afhaling of bezorging → lokaal etiket → volgen → gebeurtenissen

VLOOT

Vervoerderslabels

Verzendmethoden ophalen, tarief vragen, een vervoerderslabel boeken, de PDF downloaden en de zending volgen.

Methoden → tarief → kopen → PDF → volgen

ETIKETTEN

Verzenddiensten

De eigen verzenddiensten van het bedrijf: diensten tonen, schatten, boeken, betalen en volgen.

Diensten → schatting → aanmaken → betalen → tracking

DIENSTEN

Opslag en uitslag

Goederen inslaan in het magazijn, betalen en daarna op dit pad uitslaan.

Opslaan → betalen → kiezen → uitslaan → tracking

OPSLAG

MCP-column

MCP 47 tools

Speciale gids voor AI-agents en MCP-clients: User- vs Developer-servers, least-privilege-profielen, dry-run, goedkeuringen en live catalogus.

Profielen en scopes Menselijke goedkeuringen Dry-run writes Developer MCP

Webhaken — Webhook Integratie Gids

Ontvang real-time gebeurtenissen van Superroute — orders, statuswijzigingen, tracking-updates. Met ondertekende payloads, automatische pogingen en ingebouwde debugger.

WEBHOOKS

OTEP — Open trackinggebeurtenisprotocol

Eén gebeurtenis. Oneindig veel reizen. — Eigen bezorging, bezorging door derden en zendingen van vervoerders versmelten tot één geordende gebeurtenistijdlijn per trackingnummer.

OTEP

Gids integratie-updates

Alles wat nieuw is in de API en webhooks — idempotent annuleren, reconciliatie-feeds, v2-handtekeningen, nieuwe events — met kant-en-klare voorbeelden. Alles volledig backwards compatible.

NEW

Postman Collection

Altijd actuele collectie, live gegenereerd uit de API-documentatie — importeer in Postman en begin direct met API-aanroepen.

JSON

Orderstatus-woordenboek & flow

Het volledige orderstatus-woordenboek en de overgangsdiagrammen, live gegenereerd uit de uitgerolde code.

MARKDOWN

Tracking-eventcodes

Klantgerichte tracking-eventcodes (ophaal- en leveringszijde), OTEP-mapping, veelvoorkomende stromen en een gids om je eigen trackingpagina te bouwen met de openbare API.

TRACKING

Aan de slag

Haal uw API-token op

Kies uw API

Gebruik REST voor standaard CRUD-bewerkingen, GraphQL voor flexibele gegevensopvragen, of MCP om AI-assistenten direct te verbinden met uw logistieke gegevens.

Begin met bouwen

Open de interactieve documentatie om endpoints in de browser te testen en kopieer de codefragmenten naar uw applicatie.

Authenticatie

Alle drie API's gebruiken hetzelfde Bearer-token (verkregen via het login-endpoint). Sommige endpoints zijn openbaar en vereisen geen authenticatie — waaronder login, openbare tracking en zelfregistratie van chauffeurs.

Haal een token op via het inlogendpoint:

                # POST /api/v1/user/login

                { "email": "you@example.com", "password": "••••••••" }

Verzoekheader

Authorization: Bearer YOUR_ACCESS_TOKEN

REST Vereist voor de meeste endpoints. Login, openbare tracking en zelfregistratie van chauffeurs zijn openbaar (geen token nodig).

GQL Vereist voor geauthenticeerde bewerkingen. Openbare bewerkingen (login, tracking) werken zonder token.

MCP Optioneel. Openbare tools werken zonder token; een geldig token geeft toegang tot gepersonaliseerde gegevens.

Basis-URL's

REST API https://api.superlabel.ca/api
GraphQL https://api.superlabel.ca/api/graphql
MCP https://api.superlabel.ca/mcp

Welke API moet ik gebruiken?

REST API

Standaard CRUD-bewerkingen, webhooks, order-/routebeheer

GraphQL

Flexibele gegevensopvragen, aangepaste rapporten, geneste queries

MCP

AI-assistent integratie (Claude, Cursor, Copilot, enz.)

AI-integratie

Geef uw AI-assistent logistieke superkrachten. Maak verbinding via MCP zonder code, roep onze API rechtstreeks aan vanuit uw AI-agent, of download het vaardigheidsbestand voor volledige semantische begeleiding.

Beschikbare mogelijkheden

Openbare tracking

Zoek de bezorgstatus, gebeurtenistijdlijn en bewijs van levering (handtekening/foto) van elk pakket op via trackingnummer.

OPENBAAR

Operationele gebeurtenissen

Bekijk het volledige auditspoor van bestellingen — wie welke status heeft gewijzigd, wanneer, waar, met GPS-coördinaten en bijgevoegde foto's.

AUTHENTICATIE VEREIST

Labelservice

Haal verzendoffertes op bij vervoerders, maak verzendlabels aan, download label-PDF's, annuleer zendingen en dien einde-dag-manifesten in.

AUTHENTICATIE VEREIST

Lokale bezorging

Maak bezorg-/ophaalbestellingen aan, bouw geoptimaliseerde routes voor meerdere chauffeurs en beheer de volledige last-mile bezorgworkflow.

AUTHENTICATIE VEREIST

END USER Gebruikers-MCP-server

Voor AI-assistenten die door uw klanten worden gebruikt. Plak de configuratie en uw AI kan direct pakketten volgen — geen code nodig.

ENDPOINT

https://api.superlabel.ca/mcp

Beschikbare tools (47 live tools)

track_package Track a package by its tracking number. Returns delivery status, trackin... OPENBAAR

otep_tracking Get the unified OTEP (Open Tracking Event Protocol) timeline for a track... OPENBAAR

get_capabilities List MCP tools available to the current connection, with risk level, req... OPENBAAR

get_orders List orders with filtering and pagination. Returns order details includi... AUTH

get_order_detail Get full details of a specific order by ID, including address, status, p... AUTH

find_order Fuzzy-find orders across tracking number, external tracking, ref, recipi... AUTH

get_operation_events Get the full audit trail for orders — every status change, who performed... AUTH

create_order Create a delivery/pickup order. D=delivery (warehouse→customer), P=picku... AUTH

cancel_order Cancel an existing order by order ID. Only works for orders not yet deli... confirm

bulk_create_orders Create up to 100 delivery orders in one call. Returns a per-order succes... confirm

reroute_to_address Change the delivery address of an order that has not been picked up yet:... confirm

update_delivery_instruction Update only the delivery_instruction field on an existing order (PATCH).... AUTH

update_order_note Update only the internal note field on an existing order (PATCH). AUTH

update_time_window_by_refs Bulk-update delivery time windows (and optional schedule_date) for order... AUTH

hold_order Put an order on HOLD so it is not dispatched until release_order. HIGH-R... confirm

release_order Release an order from HOLD back to NEW_ORDER. HIGH-RISK: requires confir... confirm

propose_write Queue a write/high-risk tool for human approval instead of executing it.... AUTH

list_pending_approvals List pending MCP write approvals for this business (or mine_only). AUTH

approve_pending_write Approve and execute a pending write proposal. HIGH-RISK: requires confir... confirm

reject_pending_write Reject a pending write proposal without executing it. AUTH

get_routes List delivery routes with their status, assigned driver, and order count... AUTH

get_route_detail Get one route with its stop/order list. Prefer this over get_routes when... AUTH

get_drivers List drivers for the authenticated business (ids, names, capacity defaul... AUTH

get_driver_routes_today Orders assigned to a driver on a given date (defaults to today). Useful... AUTH

get_build_route_options List routing engines, balance modes, capacity types, and defaults before... AUTH

build_route Build/optimize a delivery route (POST /api/v3/client/build-route). HIGH-... confirm

order_snapshot One-call order context for support: order detail + operation events + pu... AUTH

list_exceptions List failed/returned/exception-like orders for a schedule date (default... AUTH

get_shipping_methods List available shipping carriers/methods. Returns IDs and names — use th... AUTH

get_shipping_rate Get a shipping cost quote. Dry-run — no label created. Returns rate opti... AUTH

create_shipping_label Book a shipment with a carrier and generate a shipping label with tracki... AUTH

quote_and_ship One-shot: rate across all enabled carriers, pick the best one by strateg... AUTH

compare_all_carriers Get rate quotes from every enabled carrier for the same shipment, in one... AUTH

search_address Search and resolve addresses by postal code or free-text query. Returns... AUTH

daily_digest One-call summary of today's logistics activity: total orders, by status,... AUTH

get_orders_summary Aggregate order metrics over a time window: counts by status, top carrie... AUTH

get_account_credits Get the authenticated customer's wallet balance, currency, and recent to... AUTH

get_warehouses List WMS warehouses available to the authenticated business. AUTH

get_inventory Query WMS inventory (POST /api/v1/wms/inventory). Pass filters supported... AUTH

list_datasets List custom datasets available to the business. AUTH

get_dataset Get one dataset by id (metadata/columns). AUTH

list_dataset_groups List groups inside a dataset. AUTH

search_dataset_records Search records across groups in a dataset (POST .../search). AUTH

list_alliances List alliances the authenticated business belongs to. AUTH

get_alliance Get one alliance by id. AUTH

list_alliance_members List members of an alliance. AUTH

list_accessible_clients List clients accessible via alliance partnerships. AUTH

// .mcp.json — ops-agent met smal profiel
{
  "mcpServers": {
    "superroute": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp",
      "headers": {
        "Authorization": "Bearer <token>",
        "X-MCP-Profile": "ops-readonly"
      }
    }
  }
}

DEVELOPER Ontwikkelaars-MCP-server

Voor AI-codeerondersteuning (Claude Code, Cursor, enz.) die u helpen Superroute-integraties te bouwen. Uw AI kan direct API's aanroepen, endpoints testen en integratiecode genereren.

ENDPOINT

https://api.superlabel.ca/mcp/developer

Beschikbare tools (25 live tools)

track_package Pakket volgen op trackingnummer OPENBAAR

get_operation_events Audittrail van bestelling ophalen AUTH

get_shipping_methods Beschikbare vervoerders tonen AUTH

get_shipping_rate Verzendtarief opvragen AUTH

create_shipping_label Verzendlabel aanmaken AUTH

get_shipping_label Labeldetails en downloadinfo AUTH

create_order Bezorg-/ophaalbestelling aanmaken AUTH

build_route Geoptimaliseerde bezorgroutes bouwen AUTH

get_build_route_options Get available options for building routes: routing engines with their balance modes, capacity ty... AUTH

get_api_endpoints Search the complete Superroute REST API catalog (the same OpenAPI spec that powers /api/document... OPENBAAR

get_graphql_operations Search the Superroute GraphQL catalog — every query and mutation, grouped by category, each with... OPENBAAR

run_graphql_query Execute a query or mutation against the Superroute GraphQL endpoint (POST /api/graphql) and retu... AUTH

get_otep_tracking Get a package's tracking history as an OTEP (Open Tracking Event Protocol) document — the normal... OPENBAAR

validate_otep_payload Run an OTEP document or event through the live conformance validator (POST /api/v1/otep/validate... OPENBAAR

check_skill_update Check if a newer version of the Superroute AI integration skill file is available. Returns curre... OPENBAAR

get_integration_guide Integratiehandleiding ophalen OPENBAAR

get_otep_guide Get the OTEP (Open Tracking Event Protocol) development guide — the What/When/Where/Why event mo... OPENBAAR

get_webhook_guide Webhook-integratiegids OPENBAAR

verify_webhook_signature Verify whether an incoming webhook signature is valid. Pass the raw payload (string or JSON obje... OPENBAAR

test_webhook_delivery Fire a real, properly-signed test webhook from Superroute servers to a URL the developer provide... AUTH

get_webhook_settings Read the caller's own webhook configuration — every per-event callback URL, the behaviour flags,... AUTH

update_webhook_settings Self-serve update of the caller's webhook configuration (PUT /api/v1/webhook-settings). Partial:... AUTH

get_order_audit_timeline Chronological audit timeline of ONE order across every source: web actions, driver app scans, wa... AUTH

get_webhook_delivery_logs List recorded webhook delivery attempts for the caller — event type, target URL, HTTP status, at... AUTH

replay_webhook_delivery Re-send a webhook that was already logged, by delivery-log id (get the id from get_webhook_deliv... AUTH

// .mcp.json — connection Bearer voorkeur
{
  "mcpServers": {
    "superroute-dev": {
      "type": "url",
      "url": "https://api.superlabel.ca/mcp/developer",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Na 2026-12-31 geen api_token in tool-argumenten. Gebruik Authorization op de MCP-verbinding.

User MCP is voor beheer met agents; Developer MCP voor integraties. Volledig model staat in de MCP-column. Open MCP-column →

AI Eindpunten voor het ontdekken van tools

Gestructureerde capaciteitsbeschrijvingen voor AI agents, LLM tool-calling-systemen en MCP clients. Alle eindpunten zijn openbaar, er is geen authenticatie vereist.

PRIMARY AI Gereedschapsmanifest

Compleet manifest met tooldefinities, schema's, verificatie-informatie en workflows.

GET https://api.superlabel.ca/api/.well-known/ai-tools.json

Ook beschikbaar: /llms.txt

FORMAT Exporteren in meerdere formaten

Ontvang gereedschapsdefinities in het formaat dat eigen is aan uw AI-platform.

# OpenAI function calling
GET https://api.superlabel.ca/api/ai/tools?format=openai

# Anthropic Claude tool_use
GET https://api.superlabel.ca/api/ai/tools?format=anthropic

# MCP tools/list
GET https://api.superlabel.ca/api/ai/tools?format=mcp

# LangChain StructuredTool
GET https://api.superlabel.ca/api/ai/tools?format=langchain

REST OpenAPI + AI Extensies

OpenAPI-specificatie verrijkt met x-ai-* extensies (toolnamen, wanneer te gebruiken, categorieën).

GET https://api.superlabel.ca/api/ai/tools/openapi

GQL GraphQL + AI Tips

GraphQL-documenten verrijkt met aiHints per bewerking (wanneer te gebruiken, gerelateerde workflows).

GET https://api.superlabel.ca/api/ai/tools/graphql

Snelle integratie

Python (OpenAI SDK )

import requests, json
tools = requests.get(
  "https://api.superlabel.ca/api/ai/tools?format=openai"
).json()["tools"]

# Pass to OpenAI
response = client.chat.completions.create(
  model="gpt-4",
  messages=messages,
  tools=tools
)

Python (Claude SDK )

import requests, anthropic
tools = requests.get(
  "https://api.superlabel.ca/api/ai/tools?format=anthropic"
).json()["tools"]

# Pass to Claude
response = client.messages.create(
  model="claude-sonnet-4-20250514",
  messages=messages,
  tools=tools
)

Node.js (ophalen)

const res = await fetch(
  "https://api.superlabel.ca/api/ai/tools?format=openai"
);
const { tools } = await res.json();

// Use with any LLM SDK
console.log(`Loaded ${tools.length} tools`);

Samenvatting van mogelijkheden: Voor een eenvoudig overzicht (alleen categorieën en gereedschapsnamen), gebruikt u GET https://api.superlabel.ca/api/ai/capabilities

AI Gereedschap Speeltuin

Test de Superroute AI-tools rechtstreeks in uw browser. Selecteer een hulpmiddel, vul de parameters in en bekijk het live API-antwoord.

Selecteer Gereedschap

track_package

Verzoektekst ( JSON )

Reactie

Klik op "Uitvoeren" om het hulpprogramma uit te voeren...

Bouw met REST of GraphQL

Voor ontwikkelaars die aangepaste AI-agenten, chatbots of programmatische integraties bouwen. Roep onze API rechtstreeks aan vanuit uw code met volledige toegang tot alle logistieke mogelijkheden.

REST REST API Eindpunten

# Pakket volgen (openbaar)
GET https://api.superlabel.ca/api/v1/tracking/{number}

# Operationele gebeurtenissen
POST https://api.superlabel.ca/api/v1/tracking/operationevents

# Verzendtarief opvragen
POST https://api.superlabel.ca/api/v1/labelservice/rate

# Verzendlabel aanmaken
POST https://api.superlabel.ca/api/v1/labelservice/submitOrder

# Bezorgbestelling aanmaken
POST https://api.superlabel.ca/api/v1/client/orderCreate

# Geoptimaliseerde route bouwen
POST https://api.superlabel.ca/api/v3/client/build-route

# Webhooks configureren
PUT https://api.superlabel.ca/api/v1/webhook-settings

# Open trackingtijdlijn (OTEP)
GET https://api.superlabel.ca/api/v1/otep/trackings/{number}

Volledige documentatie

GQL GraphQL Operaties

# Enkel endpoint
POST https://api.superlabel.ca/api/graphql

# Beschikbare operaties
trackingPublic       ← Pakket volgen (openbaar)
trackingOperationevents ← Operationele gebeurtenissen
labelserviceRate      ← Verzendtarief opvragen
labelserviceSubmitOrder ← Verzendlabel aanmaken
clientOrderCreate     ← Bezorgbestelling aanmaken
clientBuildRoute      ← Geoptimaliseerde route bouwen
webhookSettingsUpdate ← Webhooks configureren
otepTracking          ← Open trackingtijdlijn (OTEP)

Volledige documentatie

We raden de REST API aan voor de meeste AI-integraties — het is eenvoudiger te debuggen en elk endpoint is op zichzelf staand. Gebruik GraphQL wanneer u flexibele queries nodig heeft of geneste gegevens in één verzoek wilt ophalen.

Superroute AI-integratievaardigheid

Een uitgebreid vaardigheidsbestand met diepgaande logistieke domeinkennis — wat elke API doet, wanneer deze te gebruiken, wat parameters betekenen in echte bedrijfscontext, hoe resultaten te interpreteren en hoe mogelijkheden samen worden gecombineerd.

Vaardigheidsbestand downloaden (.md)

Het vaardigheidsbestand gebruiken

Claude Code

1 Download het bovenstaande bestand
2 Plaats het in de .claude/skills/ map van uw project
3 Typ /integrate in Claude Code om de interactieve wizard te starten

mkdir -p .claude/skills
cp superroute-ai-integration.md .claude/skills/

Cursor

1 Download het bovenstaande bestand
2 Plaats het in de .cursor/rules/ map van uw project
3 Cursor zal het automatisch als context gebruiken wanneer u vraagt over Superroute-integratie

mkdir -p .cursor/rules
cp superroute-ai-integration.md .cursor/rules/

Andere AI-tools

1 Download het bovenstaande bestand
2 Plak de inhoud in de systeemprompt of kennisbank van uw AI-tool
3 De AI zal de semantische beschrijvingen gebruiken om de integratie te begeleiden

# Of plak in de systeemprompt
cat superroute-ai-integration.md

Houd uw skill-bestand up-to-date

SNEL Upgrade met één commando

Download de nieuwste versie van het skill-bestand direct van de server.

# Claude Code
curl -sS https://api.superlabel.ca/api/ai-skill -o .claude/skills/superroute-ai-integration.md

# Cursor
curl -sS https://api.superlabel.ca/api/ai-skill -o .cursor/rules/superroute-ai-integration.md

API Versiecontrole-API

Controleer de nieuwste versie op de server voordat u downloadt. Vergelijk de hash met uw lokale bestand.

GET https://api.superlabel.ca/api/ai-skill/version

Antwoord:
{ "version": "1.0.0", "hash": "abc123...", "download_url": "..." }

MCP Automatische update via MCP

Als u de Developer MCP-server hebt verbonden, kan uw AI-assistent updates controleren met de check_skill_update-tool. Geef de MD5-hash van uw lokale bestand door.

// Aanroep via Developer MCP Server
{
  "method": "tools/call",
  "params": {
    "name": "check_skill_update",
    "arguments": { "current_hash": "your_local_file_md5_hash" }
  }
}

CRON Auto-update script (Cron / CI)

Voeg dit script toe aan uw CI-pipeline of cron-taak om het skill-bestand automatisch up-to-date te houden.

#!/bin/bash
# auto-update-skill.sh
SKILL_FILE=".claude/skills/superroute-ai-integration.md"
BASE_URL="https://api.superlabel.ca"

mkdir -p "$(dirname "$SKILL_FILE")"
LOCAL_HASH=$(md5sum "$SKILL_FILE" 2>/dev/null | cut -d' ' -f1)
SERVER_HASH=$(curl -s "$BASE_URL/api/ai-skill/version" | python3 -c "import sys,json; print(json.load(sys.stdin)['hash'])")

if [ "$LOCAL_HASH" != "$SERVER_HASH" ]; then
  curl -sS "$BASE_URL/api/ai-skill" -o "$SKILL_FILE"
  echo "Updated!"
fi

Het vaardigheidsbestand gaat verder dan API-documentatie — het leert uw AI-assistent de zakelijke betekenis van elke parameter, hoe antwoorden te interpreteren en hoe mogelijkheden te combineren voor complexe logistieke workflows.