Skip to content

Cerca parole Riferimento dell’API

Cerca parole: 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": "wordsearch", "preset": "word-search-for-kids", "title": "Animal word search", "input": { "words": [ "CAT", "DOG", "LION", "TIGER" ] }, "options": { "gridSize": 10, "allowDiagonal": false } }'

Modalità

normal

Configurazioni delle pagine

Formati esportabili nel browser

pdf · answer-pdf

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

CampoValore accettatoObbligatorio
presettestoNo
modetestoNo
localeuno dei valori; en | zh | es | de | fr | pt | it | id | ja | koNo
contentLanguageuno dei valori; en | zh | es | de | fr | pt | it | id | ja | koNo
titletestoSì
retentionDaysnumero; interoNo
appearance.fontFamilyuno dei valori; sans | serif | handwriting | playful | monoNo
appearance.themeColortestoNo
appearance.footerTexttesto; massimo 200No
appearance.borderStyleuno dei valori; solid | dashed | dottedNo
appearance.layoutModeuno dei valori; default | worksheetNo
appearance.pillTitlevero/falsoNo
appearance.showWorksheetHeadervero/falsoNo
appearance.outerBordervero/falsoNo
appearance.wordListPositionuno dei valori; bottom | rightNo
appearance.showGridLinesvero/falsoNo
appearance.showDirectionIconsvero/falsoNo
appearance.answerStyleuno dei valori; highlight | circle | strikethroughNo
appearance.titleScalenumero; minimo 0.5; massimo 3No
appearance.letterCaseuno dei valori; uppercase | lowercaseNo
export.paperSizeuno dei valori; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | customNo
export.widthMmnumero; minimo 50; massimo 2000No
export.heightMmnumero; minimo 50; massimo 2000No
export.unituno dei valori; mm | cm | in | pxNo
export.qualityuno dei valori; standard | high | printNo
input.wordselenco; minimo 1; massimo 200No
input.words[]testo; minimo 2; massimo 30No
input.templateIdtesto; minimo 1; massimo 100No
options.seednumero; intero; minimo 0; massimo 2147483647No
options.gridSizenumero; intero; minimo 5; massimo 30No
options.allowDiagonalvero/falsoNo
options.allowBackwardvero/falsoNo
options.fillLettersOnlyvero/falsoNo

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.

Cerca parole Riferimento dell’API