API

Direkt aus deinem System

Wenn du eine eigene Werkstattsoftware nutzt, kannst du Aufträge direkt anlegen, den Status abfragen und fertige Dateien abholen — ohne den Umweg über das Portal.

Zugang

Token erstellst du im Portal unter API-Zugang. Er wird dir genau einmal angezeigt. Schicke ihn bei jedem Aufruf im Authorization-Header mit:

Authorization: Bearer gpf_dein_token_hier

Basis-URL: https://thirsty-mclaren.85-215-252-215.plesk.page/api/v1

Endpunkte

GET /account Kontostand und verfügbare Leistungen abfragen.

GET /orders Eigene Aufträge auflisten (paginiert, per_page bis 100).

POST /orders Neuen Auftrag anlegen und Datei hochladen (multipart/form-data).

GET /orders/{id} Status und Details eines Auftrags abfragen.

GET /orders/{id}/result Freigegebene Ergebnisdatei herunterladen.

Auftrag anlegen

Die Datei geht als multipart/form-data mit. Reicht dein Guthaben nicht, antwortet die API mit 402 und legt keinen Auftrag an.

curl -X POST https://thirsty-mclaren.85-215-252-215.plesk.page/api/v1/orders \
  -H "Authorization: Bearer $GPF_TOKEN" \
  -F "file=@golf_original.bin" \
  -F "make=VW" \
  -F "model=Golf VII 1.6 TDI" \
  -F "ecu_type=EDC17C64" \
  -F "services[]=stage1" \
  -F "note=Serienhardware"

Antwort

{
  "data": {
    "id": 42,
    "reference": "#0042",
    "status": "queued",
    "credits_used": 8,
    "vehicle": { "make": "VW", "model": "Golf VII 1.6 TDI", "ecu_type": "EDC17C64" },
    "services": [ { "code": "stage1", "label": "Stage 1", "credits": 8 } ],
    "result_available": false
  }
}

Ergebnis abholen

Frage den Status ab, bis result_available auf true steht. Solange nichts freigegeben ist, antwortet der Download mit 409 — die menschliche Prüfung gilt über die API genauso wie im Portal.

curl https://thirsty-mclaren.85-215-252-215.plesk.page/api/v1/orders/42 \
  -H "Authorization: Bearer $GPF_TOKEN"

curl -OJ https://thirsty-mclaren.85-215-252-215.plesk.page/api/v1/orders/42/result \
  -H "Authorization: Bearer $GPF_TOKEN"

Fehler

Status	Code	Bedeutung
401	missing_token	Kein Authorization-Header mitgeschickt.
401	invalid_token	Token unbekannt, abgelaufen oder widerrufen.
403	account_inactive	Konto ist gesperrt oder noch nicht freigeschaltet.
402	insufficient_credits	Guthaben reicht nicht — es wurde nichts angelegt.
409	not_ready	Noch keine Datei freigegeben.
422	—	Validierungsfehler, Details im Feld errors.

Token erstellen

API-Zugang ist in jedem Konto enthalten. Melde dich an und lege unter „API-Zugang“ einen Token an.

Zum API-Zugang Konto eröffnen