Cartelle del bingo Riferimento dell’API
Cartelle del bingo: 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": "bingo", "title": "Party bingo", "input": { "words": [ "APPLE", "BANANA", "CHERRY", "DATE", "FIG", "GRAPE", "KIWI", "LEMON", "MANGO" ] }, "options": { "gridSize": 3, "cardCount": 1 } }'Modalità
classic · signature · number · blank
Configurazioni delle pagine
Formati esportabili nel browser
pdf · caller-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
| 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.themeColor | testo | No |
| appearance.title.fontFamily | uno dei valori; sans | serif | handwriting | playful | mono | No |
| appearance.title.fontWeight | uno dei valori; normal | medium | semibold | bold | extrabold | No |
| appearance.title.color | testo | No |
| appearance.title.align | uno dei valori; left | center | right | No |
| appearance.title.maxFontSize | numero; minimo 6; massimo 120 | No |
| appearance.grid.shape | uno dei valori; square | circle | No |
| appearance.grid.corners | uno dei valori; sharp | sm | md | lg | No |
| appearance.grid.gap | uno dei valori; none | sm | md | lg | No |
| appearance.grid.colorMode | uno dei valori; mono | checker | No |
| appearance.grid.bg | uno dei valori; testo | transparent | object | No |
| appearance.grid.textFontFamily | uno dei valori; sans | serif | handwriting | playful | mono | No |
| appearance.grid.textFontWeight | uno dei valori; normal | medium | semibold | bold | extrabold | No |
| appearance.grid.textColor | testo | No |
| appearance.grid.borderWidth | numero; intero; minimo 0; massimo 3 | No |
| appearance.grid.borderColor | testo | No |
| appearance.grid.borderStyle | uno dei valori; solid | dashed | dotted | No |
| appearance.card.bgColor | uno dei valori; testo | transparent | object | No |
| appearance.card.borderRadius | uno dei valori; sharp | rounded | No |
| appearance.card.borderWidth | numero; intero; minimo 0; massimo 3 | No |
| appearance.card.borderColor | testo | No |
| appearance.header.bgColor | uno dei valori; testo | transparent | object | No |
| appearance.header.fontFamily | uno dei valori; sans | serif | handwriting | playful | mono | No |
| appearance.header.fontWeight | uno dei valori; normal | medium | semibold | bold | extrabold | No |
| appearance.header.color | testo | No |
| appearance.header.maxFontSize | numero; minimo 6; massimo 120 | No |
| appearance.footer.enabled | vero/falso | No |
| appearance.footer.text | testo; massimo 200 | No |
| appearance.footer.fontFamily | uno dei valori; sans | serif | handwriting | playful | mono | No |
| appearance.footer.fontWeight | uno dei valori; normal | medium | semibold | bold | extrabold | No |
| appearance.footer.color | testo | No |
| appearance.footer.align | uno dei valori; left | center | right | No |
| appearance.footer.maxFontSize | numero; minimo 6; massimo 120 | No |
| appearance.columnHeaders | elenco; massimo 5 | No |
| appearance.columnHeaders[] | testo; minimo 1; massimo 8 | No |
| appearance.showColumnHeaders | vero/falso | No |
| appearance.randomization | uno dei valori; full | column | No |
| appearance.freeSpaceLabel | testo; massimo 40 | No |
| appearance.signatureLines | vero/falso | No |
| appearance.fontFamily | uno dei valori; sans | serif | handwriting | playful | mono | No |
| appearance.fontSize | uno dei valori; small | medium | large | No |
| appearance.headerBgColor | testo | No |
| appearance.showGridLines | vero/falso | No |
| appearance.outerBorder | vero/falso | No |
| appearance.borderStyle | uno dei valori; solid | dashed | dotted | 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.layout | uno dei valori; 1x1 | 1x2 | 2x2 | 2x4 | No |
| input.words | elenco; minimo 1; massimo 200 | No |
| input.words[] | testo; minimo 1; massimo 50 | No |
| input.numbers | elenco | No |
| input.numbers[] | numero; intero; minimo 0; massimo 9999 | No |
| options.seed | numero; intero; minimo 0; massimo 2147483647 | No |
| options.gridSize | uno dei valori; 3 | 4 | 5 | No |
| options.cardCount | numero; intero; minimo 1; massimo 100 | No |
| options.freeSpace | vero/falso | No |
| options.minNumber | numero; intero; minimo 0; massimo 9999 | No |
| options.maxNumber | numero; intero; minimo 0; massimo 9999 | No |
| options.ballCount | uno dei valori; 30 | 75 | 80 | No |
| options.signatureLine | vero/falso | 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.