REST-Referenz für Rätsel

Verwenden Sie einen Bearer-Schlüssel. Die Erstellung speichert das vollständige Ergebnis unter Meine Rätsel und liefert Browserseiten statt Dateidaten.

API Schlüssel

Authentifizierung

Senden Sie Authorization: Bearer YOUR_API_KEY. Externe Endpunkte akzeptieren keine Cookies. Bewahren Sie den Schlüssel auf Ihrem Server auf.

Limits und Freigaben

Beispielanfrage

curl -X POST https://puzzlegenio.com/api/v1/puzzles \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Idempotency-Key: task-000000000001' \
  -H 'Content-Type: application/json' \
  -d '{ "type": "wordsearch", "preset": "word-search-for-kids", "title": "Animal word search", "input": { "words": [ "CAT", "DOG", "LION", "TIGER" ] }, "options": { "gridSize": 10, "allowDiagonal": false } }'

Beispiel einer erfolgreichen Antwort

{
  "data": {
    "savedId": "123456789",
    "shareId": "AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "type": "wordsearch",
    "preset": "word-search-for-kids",
    "viewUrl": "https://puzzlegenio.com/puzzles/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "exportPageUrl": "https://puzzlegenio.com/puzzles/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "editUrl": "https://puzzlegenio.com/word-search-for-kids?id=123456789",
    "playUrl": "https://puzzlegenio.com/word-search-maker/play/AbCdEfGhIjKlMnOpQrStUvWxYz012345",
    "expiresAt": "2026-11-01T00:00:00.000Z",
    "shareState": "active",
    "savedCount": 1,
    "limit": 20,
    "formats": [
      "pdf",
      "answer-pdf"
    ],
    "itemCount": 1,
    "warnings": []
  },
  "requestId": "00000000-0000-4000-8000-000000000000"
}

Kennungen und Datum zeigen nur die Struktur. data enthält das gespeicherte Ergebnis; requestId kennzeichnet die Anfrage.

viewUrl: Öffentliche Vorschau; wer den Link hat, kann auch die Lösungen sehen.
exportPageUrl: Browserseite zur Wahl eines Downloadformats. Sie kann mit viewUrl identisch sein und ist kein Dateilink.
editUrl: Bearbeitungsseite nur für Eigentümer; Anmeldung und Besitz werden geprüft.
playUrl: Spielseite nur für unterstützte Modi; sonst null.

REST-Endpunkte

POST	/api/v1/puzzles
GET	/api/v1/puzzles
GET	/api/v1/puzzles/{savedId}
DELETE	/api/v1/puzzles/{savedId}
POST	/api/v1/puzzles/{savedId}/share
GET	/api/v1/capabilities
GET	/api/v1/results/{shareId}
POST	/api/v1/assets
POST	/api/v1/assets/import
GET	/api/v1/openapi.json

Maschinenlesbares OpenAPI-Schema

Idempotenz und Antworten

Für die Erstellung ist Idempotency-Key erforderlich. Gleicher Schlüssel und gleicher Inhalt liefern dasselbe gespeicherte Rätsel. Ein anderer Inhalt mit demselben Schlüssel führt zu 409. Die erste Erstellung liefert 201, eine Wiederholung 200.

Fehler

Fehler haben die Form {error:{code,message,details},requestId}. 400 bedeutet ungültige Anfrage, 401 fehlende Authentifizierung, 403 Limit oder Berechtigung, 404 unbekanntes oder fremdes Objekt, 409 Konflikt, 410 ungültige Freigabe, 413 zu große Daten, 415 falscher Medientyp, 422 unpassende Eingaben, 429 Drosselung mit Retry-After und 503 nicht verfügbare Erstellung.