TruckSlot API – Zählerstand-Integration

📡 Überblick

Die TruckSlot-API erlaubt es Betreibern von Raststätten, Autohöfen und Rastparks, ihren Belegungszähler automatisch zu posten. Jeder Post aktualisiert den Status des Parkplatzes in der TruckSlot-App — Fahrer sehen sofort, ob der Parkplatz frei, teilweise belegt oder voll ist.

⚠️ Wichtig: Die API ist ausschließlich zum POSTEN von Zählerständen gedacht. Es gibt keinen Lesezugriff auf fremde Daten — kein Abrufen von Beständen, keine Listen, kein Status-Read für Dritte.

POST onlyAPI-KeyJSONRate-Limit 5 min

🔑 Zugangsdaten anfordern

Jeder Standort erhält einen persönlichen API-Key. Der Key ist fest mit genau einem Parkplatz verknüpft — ein Key kann ausschließlich für den eigenen Standort posten.

Key anfordern: hermes@cstrsk.de mit Standortname und Autobahn.

Bearbeitung in der Regel innerhalb von 24 Stunden. Kostenlos.

POST Zählerstand melden

Sendet den aktuellen Zählerstand (belegte Stellplätze) des Parkplatzes. Der Status wird automatisch berechnet.

Endpoint

POST https://cstrsk.de/TruckSlot/api.php

Request-Header

Content-Type: application/json

Request-Body (JSON)

{
  "api_key": "DEIN_API_KEY",
  "spot_id": "a8-3",
  "counter": 42
}

Parameter

Feld	Typ	Pflicht	Beschreibung
`api_key`	string	ja	Persönlicher API-Key (wird zugeteilt)
`spot_id`	string	ja	ID des Parkplatzes (wird mit dem Key mitgeteilt)
`counter`	integer	ja	Aktuell belegte Stellplätze (Zählerstand)

Status-Berechnung (automatisch)

Belegung	Status	Farbe
0–30 % der Kapazität	FREE	🟢 Frei
31–85 % der Kapazität	FEW	🟡 Wenige Plätze
86–100 % der Kapazität	FULL	🔴 Voll

Beispiel: cURL

curl -X POST https://cstrsk.de/TruckSlot/api.php \
  -H "Content-Type: application/json" \
  -d '{"api_key":"DEIN_KEY","spot_id":"a8-3","counter":42}'

Beispiel: Python

import requests

r = requests.post("https://cstrsk.de/TruckSlot/api.php", json={
    "api_key": "DEIN_KEY",
    "spot_id": "a8-3",
    "counter": 42
})
print(r.json())

Beispiel: PHP

$ch = curl_init("https://cstrsk.de/TruckSlot/api.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    "api_key" => "DEIN_KEY",
    "spot_id" => "a8-3",
    "counter" => 42
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

✅ Erfolgreiche Antwort

{
  "ok": true,
  "spot_id": "a8-3",
  "source": "counter",
  "counter": 42,
  "capacity": 100,
  "new_status": "FEW",
  "submissions": 1
}

Feld	Beschreibung
`ok`	true bei Erfolg
`source`	immer `"counter"` (Zähler-Quelle)
`counter`	Gemeldeter Zählerstand (Echo)
`capacity`	Hinterlegte Gesamtkapazität
`new_status`	Berechneter Status: FREE / FEW / FULL

❌ Fehlerantworten

HTTP	Fehler	Bedeutung
400	`missing_fields`	api_key, spot_id oder counter fehlt
403	`invalid_api_key`	API-Key unbekannt oder ungültig
403	`key_spot_mismatch`	Key gehört zu einem anderen Parkplatz
404	`spot_not_found`	Parkplatz-ID existiert nicht
429	`rate_limit`	Zu viele Posts (max. 1 pro 5 Minuten)

{
  "ok": false,
  "error": "invalid_api_key"
}

🔒 Sicherheit & Limits

POST only: Kein Endpoint zum Lesen fremder Daten. Bestände, Listen und Status sind nicht abrufbar.
Key-Bindung: Jeder API-Key ist fest mit genau einem Parkplatz verknüpft.
Rate-Limit: Maximal 1 Zählerstand pro 5 Minuten pro Parkplatz (Zähler ändern sich selten schneller).
Validierung: Zählerstand muss eine nicht-negative Ganzzahl sein; unrealistische Werte werden abgelehnt.
HTTPS: Nur verschlüsselte Übertragung.
Ringpuffer: Der Status wird nach max. 3 Posts oder 60 Minuten automatisch zurückgesetzt, falls die Zähler-Übertragung ausfällt.

🚀 Loslegen

API-Key für deinen Standort anfordern — kostenlos und in 24 Stunden.

API-Key anfordern

🚛 TruckSlot API