🛠️ API für Spieleentwickler
Spiele anmelden, Versionen ausliefern, Wünsche der Tester abholen und beantworten – automatisiert.
1. Zugang
- Unter Registrieren ein Konto anlegen und „Spieleentwickler“ wählen.
- Wir schalten das Konto manuell frei.
- Im Profil einen API-Token erzeugen (beginnt mit
gt_, wird nur einmal angezeigt). - 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
- Tester spielen täglich und hinterlegen Änderungswünsche (mit Screenshots).
- Ihr holt offene Wünsche ab:
GET /games/{slug}/feedback?status=offen - Ihr antwortet und setzt den Status, z. B.
in_arbeitoderrueckfrage. - Neue Version hochladen:
POST /games/{slug}/builds– im Changelog auf die Wünsche hinweisen (#12). - Erledigte Wünsche auf
umgesetztsetzen mitresolved_version. Am nächsten Tag testen die Spieler die neue Version.
3. Spiele
Alle Spiele, bei denen du Entwickler bist.
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, …}
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
Tester mit letztem Testtag und Anzahl Testtage.
4. Versionen (Installer)
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": "…"}, …]}
5. Änderungswünsche
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"}]
Ein Wunsch mit vollständigem Verlauf (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
Nur Status ändern: {"status": "in_arbeit", "comment": "optional"}
Bild eines Wunsches herunterladen.
Werte
| Feld | Werte |
|---|---|
status | neu (Neu), angenommen (Angenommen), in_arbeit (In Arbeit), rueckfrage (Rückfrage), umgesetzt (Umgesetzt), abgelehnt (Abgelehnt) |
category | bug, wunsch, balancing, grafik, sound, steuerung, sonstiges |
priority | niedrig, 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).
Ohne Token – Erreichbarkeitstest.