Puzzle Riferimento dell’API
Puzzle: Questa guida ricava modalità, configurazioni, formati e campi dallo stesso registro e contratto dell’API.
Esempio di richiesta
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" } }'Modalità
normal
Configurazioni delle pagine
Formati esportabili nel browser
svg · pdf · png · dxf · zip · stl
I formati dipendono dalle impostazioni e dal piano. viewUrl ed exportPageUrl aprono il download nel browser; la risposta non contiene file PDF, PNG o STL. I diritti sono fissati alla pubblicazione e ricontrollati quando si ripubblica.
Campi comuni
| Campo | Valore accettato | Obbligatorio |
|---|---|---|
| preset | testo | No |
| mode | testo | No |
| locale | uno dei valori; en | zh | es | de | fr | pt | it | id | ja | ko | No |
| contentLanguage | uno dei valori; en | zh | es | de | fr | pt | it | id | ja | ko | No |
| title | testo | Sì |
| retentionDays | numero; intero | No |
| appearance.lineColor | testo | No |
| appearance.lineWidth | numero; minimo 0; massimo 20 | No |
| appearance.strokeOutline | vero/falso | No |
| appearance.outlineColor | testo | No |
| appearance.outlineWidth | numero; minimo 0; massimo 10 | No |
| export.paperSize | uno dei valori; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | custom | No |
| export.widthMm | numero; minimo 50; massimo 2000 | No |
| export.heightMm | numero; minimo 50; massimo 2000 | No |
| export.unit | uno dei valori; mm | cm | in | px | No |
| export.quality | uno dei valori; standard | high | print | No |
| export.thicknessMm | numero; minimo 1; massimo 10 | No |
| export.gapMm | numero; minimo 0.1; massimo 1 | No |
| input.imageAssetId | testo | No |
| options.seed | numero; intero; minimo 0; massimo 2147483647 | No |
| options.tilesX | numero; intero; minimo 1; massimo 100 | No |
| options.tilesY | numero; intero; minimo 1; massimo 100 | No |
| options.sizeX | numero; minimo 1; massimo 10000 | No |
| options.sizeY | numero; minimo 1; massimo 10000 | No |
| options.tabSize | numero; minimo 10; massimo 35 | No |
| options.jitter | numero; minimo 0; massimo 10 | No |
| options.cornerRadius | numero; minimo 0; massimo 100 | No |
| options.shape | testo; minimo 1; massimo 50 | No |
| options.hexRings | numero; intero; minimo 1; massimo 20 | No |
Modelli e temi
Consulta /api/v1/capabilities per conoscere modelli, temi e limiti del tuo account. Anche un modello creato occupa uno spazio.
Immagini e file
Per le immagini usa un assetId caricato o importato dallo stesso account. Il download avviene nella pagina del risultato; l’indirizzo della pagina non è un collegamento diretto al file.
Casi di errore
Campi sconosciuti o combinazioni incompatibili di type, mode e preset restituiscono 422. Anche un input che non produce un rompicapo completo restituisce 422. I formati dipendono dalle impostazioni e dal piano.