Cartelas de bingo Referência da API

Cartelas de bingo: Esta referência obtém modos, configurações, formatos e campos do mesmo registro e contrato da API.

Exemplo de solicitação

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

Modos

classic · signature · number · blank

Configurações de página

Formatos de exportação no navegador

pdf · caller-pdf

Os formatos dependem das configurações e do plano. viewUrl e exportPageUrl levam ao download no navegador; a resposta não contém arquivos PDF, PNG ou STL. As permissões são fixadas na publicação e revistas ao republicar.

Campos comuns

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

Modelos e temas

Consulte /api/v1/capabilities para ver modelos, temas e limites da conta. Usar um modelo também ocupa uma vaga salva.

Imagens e arquivos

A entrada de imagem usa um assetId enviado ou importado pela mesma conta. O download acontece na página do resultado; o endereço dessa página não é um arquivo direto.

Casos de erro

Campos desconhecidos ou combinações incompatíveis de type, mode e preset retornam 422. Entradas que não geram um quebra-cabeça completo também retornam 422. Os formatos dependem das configurações e do plano.