Labyrinthe Schnittstellenreferenz
Labyrinthe: Diese Referenz liest Modi, Vorlagen, Formate und Felder aus demselben Register und Eingabevertrag wie die Schnittstelle.
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": "maze", "title": "Simple maze", "options": { "cols": 10, "rows": 10, "algorithm": "backtracker" } }'Modi
normal
Seitenvorlagen
Exportformate im Browser
pdf · svg · png
Formate richten sich nach Konfiguration und Tarif. viewUrl und exportPageUrl fĂŒhren zum Download im Browser; die Antwort enthĂ€lt keine PDF-, PNG- oder STL-Daten. Berechtigungen werden bei der Veröffentlichung festgelegt und bei erneuter Veröffentlichung geprĂŒft.
Gemeinsame Anfragefelder
| Feld | ZulÀssiger Wert | Pflichtfeld |
|---|---|---|
| preset | Text | Nein |
| mode | Text | Nein |
| locale | einer der Werte; en | zh | es | de | fr | pt | it | id | ja | ko | Nein |
| contentLanguage | einer der Werte; en | zh | es | de | fr | pt | it | id | ja | ko | Nein |
| title | Text | Ja |
| retentionDays | Zahl; Ganzzahl | Nein |
| appearance.wallColor | Text | Nein |
| appearance.wallStrokeWidth | Zahl; mindestens 0.1; höchstens 20 | Nein |
| appearance.backgroundColor | Text | Nein |
| appearance.startEndMarker | einer der Werte; arrow | text | Zahl | none | Nein |
| appearance.startEndLabelColor | Text | Nein |
| appearance.answerPathColor | Text | Nein |
| appearance.answerPathWidth | Zahl; mindestens 0.1; höchstens 20 | Nein |
| appearance.cornerStyle | einer der Werte; sharp | rounded | Nein |
| export.paperSize | einer der Werte; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | custom | Nein |
| export.widthMm | Zahl; mindestens 50; höchstens 2000 | Nein |
| export.heightMm | Zahl; mindestens 50; höchstens 2000 | Nein |
| export.unit | einer der Werte; mm | cm | in | px | Nein |
| export.quality | einer der Werte; standard | high | print | Nein |
| options.seed | Zahl; Ganzzahl; mindestens 0; höchstens 2147483647 | Nein |
| options.cols | Zahl; Ganzzahl; mindestens 5; höchstens 200 | Nein |
| options.rows | Zahl; Ganzzahl; mindestens 5; höchstens 200 | Nein |
| options.algorithm | einer der Werte; backtracker | prim | kruskal | Nein |
| options.difficulty | einer der Werte; kids | easy | medium | hard | impossible | Nein |
| options.startPosition | Text | Nein |
| options.endPosition | Text | Nein |
Vorlagen und Themen
Aktuelle Vorlagenkennungen, Themen und Kontogrenzen finden Sie unter /api/v1/capabilities. Auch eine Vorlage belegt einen Speicherplatz.
Bilder und Dateien
Bildeingaben verwenden eine zuvor hochgeladene oder importierte assetId desselben Kontos. Downloads erfolgen auf der Ergebnisseite im Browser; deren Link ist kein direkter Dateilink.
FehlerfÀlle
Unbekannte Felder oder widersprĂŒchliche Kombinationen aus type, mode und preset ergeben 422. Dasselbe gilt fĂŒr Eingaben, aus denen kein vollstĂ€ndiges RĂ€tsel entsteht. Formate hĂ€ngen von Konfiguration und Tarif ab.