Anmelden

🛠️ API für Spieleentwickler

Spiele anmelden, Versionen ausliefern, Wünsche der Tester abholen und beantworten – automatisiert.

1. Zugang

  1. Unter Registrieren ein Konto anlegen und „Spieleentwickler“ wählen.
  2. Wir schalten das Konto manuell frei.
  3. Im Profil einen API-Token erzeugen (beginnt mit gt_, wird nur einmal angezeigt).
  4. Jeden Request mit dem Header Authorization: Bearer gt_… senden.

Basis-URL: http://gametests.meyer-edv.cloud/api/v1 · Antworten in JSON · Request-Bodies als JSON oder multipart/form-data (für Datei-Uploads).

export GT_TOKEN="gt_xxxxxxxxxxxxxxxx"
curl -H "Authorization: Bearer $GT_TOKEN" http://gametests.meyer-edv.cloud/api/v1/me

2. Der tägliche Ablauf

  1. Tester spielen täglich und hinterlegen Änderungswünsche (mit Screenshots).
  2. Ihr holt offene Wünsche ab: GET /games/{slug}/feedback?status=offen
  3. Ihr antwortet und setzt den Status, z. B. in_arbeit oder rueckfrage.
  4. Neue Version hochladen: POST /games/{slug}/builds – im Changelog auf die Wünsche hinweisen (#12).
  5. Erledigte Wünsche auf umgesetzt setzen mit resolved_version. Am nächsten Tag testen die Spieler die neue Version.

3. Spiele

GET/api/v1/games

Alle Spiele, bei denen du Entwickler bist.

POST/api/v1/games

Neues Spiel anmelden. Du wirst automatisch als Entwickler eingetragen; Tester ordnet das Admin-Team zu.

curl -X POST http://gametests.meyer-edv.cloud/api/v1/games \
  -H "Authorization: Bearer $GT_TOKEN" -H "Content-Type: application/json" \
  -d '{"name": "Sternenfänger", "short_desc": "Ein gemütlicher Weltraum-Plattformer",
       "description": "Lange Beschreibung …", "accent": "#8b5cf6",
       "webhook_url": "https://ci.example.com/hooks/gametests"}'
{"slug": "sternenfaenger", "name": "Sternenfänger", "latest_version": null, "active": true, …}
GET/api/v1/games/{slug}
PATCH/api/v1/games/{slug}

Felder name, short_desc, description, accent, webhook_url; Titelbild als Multipart-Feld cover.

curl -X PATCH http://gametests.meyer-edv.cloud/api/v1/games/sternenfaenger -H "Authorization: Bearer $GT_TOKEN" \
  -F short_desc="Jetzt mit Koop-Modus" -F cover=@cover.png
GET/api/v1/games/{slug}/testers

Tester mit letztem Testtag und Anzahl Testtage.

4. Versionen (Installer)

POST/api/v1/games/{slug}/builds

Multipart-Upload. Felder: version (Pflicht, eindeutig), changelog, windows (.exe/.msi), linux (.deb). Mindestens eine Datei. Max. 6 GB pro Request.

curl -X POST http://gametests.meyer-edv.cloud/api/v1/games/sternenfaenger/builds \
  -H "Authorization: Bearer $GT_TOKEN" \
  -F version=0.4.2 \
  -F changelog=$'- Sprunghöhe angepasst (#12)\n- Absturz im Menü behoben (#15)' \
  -F windows=@dist/Sternenfaenger-Setup-0.4.2.exe \
  -F linux=@dist/sternenfaenger_0.4.2_amd64.deb
{"id": 7, "version": "0.4.2", "files": [{"platform": "windows", "size": 104857600, "sha256": "…"}, …]}
GET/api/v1/games/{slug}/builds
DELETE/api/v1/games/{slug}/builds/{version}

5. Änderungswünsche

GET/api/v1/games/{slug}/feedback

Parameter: status (offen oder kommagetrennt, z. B. neu,rueckfrage), since (ISO-Zeitstempel, nur seitdem geänderte), full=1 (inkl. Verlauf).

curl -H "Authorization: Bearer $GT_TOKEN" \
  "http://gametests.meyer-edv.cloud/api/v1/games/sternenfaenger/feedback?status=offen"
[{"id": 12, "title": "Sprung zu träge", "body": "…", "category": "steuerung", "priority": "normal",
  "status": "neu", "author": "Max", "tested_version": "0.4.1", "resolved_version": null,
  "attachments": [{"id": 3, "filename": "screenshot.png", "url": "http://gametests.meyer-edv.cloud/api/v1/attachments/3"}],
  "created_at": "2026-11-21T18:03:11+00:00", "url": "http://gametests.meyer-edv.cloud/wunsch/12"}]
GET/api/v1/feedback/{id}

Ein Wunsch mit vollständigem Verlauf (comments).

POST/api/v1/feedback/{id}/comments

Rückmeldung an den Tester. Felder: body, optional status, resolved_version, Bilder als Multipart images (mehrfach).

curl -X POST http://gametests.meyer-edv.cloud/api/v1/feedback/12/comments -H "Authorization: Bearer $GT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"body": "Ist in 0.4.2 drin – bitte morgen nochmal testen!", "status": "umgesetzt", "resolved_version": "0.4.2"}'

# mit Bild:
curl -X POST http://gametests.meyer-edv.cloud/api/v1/feedback/12/comments -H "Authorization: Bearer $GT_TOKEN" \
  -F body="So sieht es jetzt aus:" -F images=@vorher.png -F images=@nachher.png
PATCH/api/v1/feedback/{id}

Nur Status ändern: {"status": "in_arbeit", "comment": "optional"}

GET/api/v1/attachments/{id}

Bild eines Wunsches herunterladen.

Werte

FeldWerte
statusneu (Neu), angenommen (Angenommen), in_arbeit (In Arbeit), rueckfrage (Rückfrage), umgesetzt (Umgesetzt), abgelehnt (Abgelehnt)
categorybug, wunsch, balancing, grafik, sound, steuerung, sonstiges
priorityniedrig, normal, hoch, kritisch

6. Webhooks

Ist beim Spiel eine webhook_url hinterlegt, sendet die Plattform bei Ereignissen einen JSON-POST:

{"event": "feedback.created", "game": "sternenfaenger", "feedback_id": 12,
 "title": "Sprung zu träge", "category": "steuerung", "priority": "normal",
 "author": "Max", "url": "http://gametests.meyer-edv.cloud/wunsch/12"}

Ereignisse: feedback.created, feedback.commented, build.published.

7. Fehler

Fehler kommen als {"error": "…"} mit HTTP-Status 400 (ungültige Eingabe), 401 (Token fehlt/ungültig), 403 (kein Entwickler), 404 (nicht gefunden/kein Zugriff).

GET/api/v1/health

Ohne Token – Erreichbarkeitstest.