GP Fileservice
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://www.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://www.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://www.thirsty-mclaren.85-215-252-215.plesk.page/api/v1/orders/42 \
  -H "Authorization: Bearer $GPF_TOKEN"

curl -OJ https://www.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.