Cartones de bingo Referencia de la API

Cartones de bingo: Esta referencia toma modalidades, configuraciones, formatos y campos del mismo registro y contrato que la API.

Claves API

Ejemplo de solicitud

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 } }'

Modalidades

classic · signature · number · blank

Configuraciones de página

Formatos de descarga en el navegador

pdf · caller-pdf

Los formatos dependen de la configuración y del plan. viewUrl y exportPageUrl llevan a la descarga en el navegador; la respuesta no incluye datos PDF, PNG ni STL. Los permisos se fijan al publicar y se vuelven a comprobar al republicar.

Campos comunes

Campo	Valor admitido	Obligatorio
preset	texto	No
mode	texto	No
locale	una opción; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	No
contentLanguage	una opción; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	No
title	texto	Sí
retentionDays	número; entero	No
appearance.themeColor	texto	No
appearance.title.fontFamily	una opción; sans \| serif \| handwriting \| playful \| mono	No
appearance.title.fontWeight	una opción; normal \| medium \| semibold \| bold \| extrabold	No
appearance.title.color	texto	No
appearance.title.align	una opción; left \| center \| right	No
appearance.title.maxFontSize	número; mínimo 6; máximo 120	No
appearance.grid.shape	una opción; square \| circle	No
appearance.grid.corners	una opción; sharp \| sm \| md \| lg	No
appearance.grid.gap	una opción; none \| sm \| md \| lg	No
appearance.grid.colorMode	una opción; mono \| checker	No
appearance.grid.bg	una opción; texto \| transparent \| object	No
appearance.grid.textFontFamily	una opción; sans \| serif \| handwriting \| playful \| mono	No
appearance.grid.textFontWeight	una opción; normal \| medium \| semibold \| bold \| extrabold	No
appearance.grid.textColor	texto	No
appearance.grid.borderWidth	número; entero; mínimo 0; máximo 3	No
appearance.grid.borderColor	texto	No
appearance.grid.borderStyle	una opción; solid \| dashed \| dotted	No
appearance.card.bgColor	una opción; texto \| transparent \| object	No
appearance.card.borderRadius	una opción; sharp \| rounded	No
appearance.card.borderWidth	número; entero; mínimo 0; máximo 3	No
appearance.card.borderColor	texto	No
appearance.header.bgColor	una opción; texto \| transparent \| object	No
appearance.header.fontFamily	una opción; sans \| serif \| handwriting \| playful \| mono	No
appearance.header.fontWeight	una opción; normal \| medium \| semibold \| bold \| extrabold	No
appearance.header.color	texto	No
appearance.header.maxFontSize	número; mínimo 6; máximo 120	No
appearance.footer.enabled	verdadero/falso	No
appearance.footer.text	texto; máximo 200	No
appearance.footer.fontFamily	una opción; sans \| serif \| handwriting \| playful \| mono	No
appearance.footer.fontWeight	una opción; normal \| medium \| semibold \| bold \| extrabold	No
appearance.footer.color	texto	No
appearance.footer.align	una opción; left \| center \| right	No
appearance.footer.maxFontSize	número; mínimo 6; máximo 120	No
appearance.columnHeaders	lista; máximo 5	No
appearance.columnHeaders[]	texto; mínimo 1; máximo 8	No
appearance.showColumnHeaders	verdadero/falso	No
appearance.randomization	una opción; full \| column	No
appearance.freeSpaceLabel	texto; máximo 40	No
appearance.signatureLines	verdadero/falso	No
appearance.fontFamily	una opción; sans \| serif \| handwriting \| playful \| mono	No
appearance.fontSize	una opción; small \| medium \| large	No
appearance.headerBgColor	texto	No
appearance.showGridLines	verdadero/falso	No
appearance.outerBorder	verdadero/falso	No
appearance.borderStyle	una opción; solid \| dashed \| dotted	No
export.paperSize	una opción; A3 \| A4 \| A4-landscape \| A5 \| B5 \| Letter \| Letter-landscape \| Legal \| Half-Letter \| Tabloid \| custom	No
export.widthMm	número; mínimo 50; máximo 2000	No
export.heightMm	número; mínimo 50; máximo 2000	No
export.unit	una opción; mm \| cm \| in \| px	No
export.quality	una opción; standard \| high \| print	No
export.layout	una opción; 1x1 \| 1x2 \| 2x2 \| 2x4	No
input.words	lista; mínimo 1; máximo 200	No
input.words[]	texto; mínimo 1; máximo 50	No
input.numbers	lista	No
input.numbers[]	número; entero; mínimo 0; máximo 9999	No
options.seed	número; entero; mínimo 0; máximo 2147483647	No
options.gridSize	una opción; 3 \| 4 \| 5	No
options.cardCount	número; entero; mínimo 1; máximo 100	No
options.freeSpace	verdadero/falso	No
options.minNumber	número; entero; mínimo 0; máximo 9999	No
options.maxNumber	número; entero; mínimo 0; máximo 9999	No
options.ballCount	una opción; 30 \| 75 \| 80	No
options.signatureLine	verdadero/falso	No

Plantillas y temas

Consulta /api/v1/capabilities para conocer las plantillas, los temas y los límites de tu cuenta. Una plantilla creada también ocupa una plaza de guardado.

Imágenes y archivos

La imagen se indica mediante un assetId subido o importado por la misma cuenta. La descarga se realiza en la página del resultado; su enlace no es un archivo directo.

Casos de error

Los campos desconocidos y las combinaciones incompatibles de type, mode y preset devuelven 422. También devuelve 422 una entrada que no permita completar el pasatiempo. Los formatos dependen de la configuración y del plan.