Puzzles Référence de l’API

Puzzles: Cette référence tire les modes, modèles, formats et champs du registre et du contrat utilisés par l’API.

Exemple de requête

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": "jigsaw", "title": "Mountain puzzle", "options": { "tilesX": 5, "tilesY": 5, "shape": "rectangle" } }'

Modes

normal

Modèles de pages

Formats exportés dans le navigateur

svg · pdf · png · dxf · zip · stl

Les formats dépendent des réglages et de l’abonnement. viewUrl et exportPageUrl mènent au téléchargement dans le navigateur ; la réponse ne contient aucun fichier PDF, PNG ou STL. Les droits sont figés à la publication et vérifiés à nouveau lors d’une republication.

Champs communs

Champ	Valeur acceptée	Obligatoire
preset	texte	Non
mode	texte	Non
locale	au choix; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Non
contentLanguage	au choix; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Non
title	texte	Oui
retentionDays	nombre; entier	Non
appearance.lineColor	texte	Non
appearance.lineWidth	nombre; minimum 0; maximum 20	Non
appearance.strokeOutline	vrai/faux	Non
appearance.outlineColor	texte	Non
appearance.outlineWidth	nombre; minimum 0; maximum 10	Non
export.paperSize	au choix; A3 \| A4 \| A4-landscape \| A5 \| B5 \| Letter \| Letter-landscape \| Legal \| Half-Letter \| Tabloid \| custom	Non
export.widthMm	nombre; minimum 50; maximum 2000	Non
export.heightMm	nombre; minimum 50; maximum 2000	Non
export.unit	au choix; mm \| cm \| in \| px	Non
export.quality	au choix; standard \| high \| print	Non
export.thicknessMm	nombre; minimum 1; maximum 10	Non
export.gapMm	nombre; minimum 0.1; maximum 1	Non
input.imageAssetId	texte	Non
options.seed	nombre; entier; minimum 0; maximum 2147483647	Non
options.tilesX	nombre; entier; minimum 1; maximum 100	Non
options.tilesY	nombre; entier; minimum 1; maximum 100	Non
options.sizeX	nombre; minimum 1; maximum 10000	Non
options.sizeY	nombre; minimum 1; maximum 10000	Non
options.tabSize	nombre; minimum 10; maximum 35	Non
options.jitter	nombre; minimum 0; maximum 10	Non
options.cornerRadius	nombre; minimum 0; maximum 100	Non
options.shape	texte; minimum 1; maximum 50	Non
options.hexRings	nombre; entier; minimum 1; maximum 20	Non

Modèles et thèmes

Consultez /api/v1/capabilities pour connaître les modèles, thèmes et limites de votre compte. Un jeu créé à partir d’un modèle occupe aussi une place.

Images et fichiers

Une image est désignée par un assetId préalablement importé ou envoyé depuis le même compte. Le téléchargement se fait dans le navigateur ; le lien du résultat n’est pas un fichier direct.

Cas d’erreur

Les champs inconnus ou les associations incompatibles de type, mode et preset renvoient 422. Une entrée ne permettant pas de produire un jeu complet renvoie également 422. Les formats dépendent des réglages et du compte.