Bingokarten Schnittstellenreferenz

Bingokarten: Diese Referenz liest Modi, Vorlagen, Formate und Felder aus demselben Register und Eingabevertrag wie die Schnittstelle.

API Schlüssel

Beispielanfrage

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

Modi

classic · signature · number · blank

Seitenvorlagen

Exportformate im Browser

pdf · caller-pdf

Formate richten sich nach Konfiguration und Tarif. viewUrl und exportPageUrl führen zum Download im Browser; die Antwort enthält keine PDF-, PNG- oder STL-Daten. Berechtigungen werden bei der Veröffentlichung festgelegt und bei erneuter Veröffentlichung geprüft.

Gemeinsame Anfragefelder

Feld	Zulässiger Wert	Pflichtfeld
preset	Text	Nein
mode	Text	Nein
locale	einer der Werte; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Nein
contentLanguage	einer der Werte; en \| zh \| es \| de \| fr \| pt \| it \| id \| ja \| ko	Nein
title	Text	Ja
retentionDays	Zahl; Ganzzahl	Nein
appearance.themeColor	Text	Nein
appearance.title.fontFamily	einer der Werte; sans \| serif \| handwriting \| playful \| mono	Nein
appearance.title.fontWeight	einer der Werte; normal \| medium \| semibold \| bold \| extrabold	Nein
appearance.title.color	Text	Nein
appearance.title.align	einer der Werte; left \| center \| right	Nein
appearance.title.maxFontSize	Zahl; mindestens 6; höchstens 120	Nein
appearance.grid.shape	einer der Werte; square \| circle	Nein
appearance.grid.corners	einer der Werte; sharp \| sm \| md \| lg	Nein
appearance.grid.gap	einer der Werte; none \| sm \| md \| lg	Nein
appearance.grid.colorMode	einer der Werte; mono \| checker	Nein
appearance.grid.bg	einer der Werte; Text \| transparent \| object	Nein
appearance.grid.textFontFamily	einer der Werte; sans \| serif \| handwriting \| playful \| mono	Nein
appearance.grid.textFontWeight	einer der Werte; normal \| medium \| semibold \| bold \| extrabold	Nein
appearance.grid.textColor	Text	Nein
appearance.grid.borderWidth	Zahl; Ganzzahl; mindestens 0; höchstens 3	Nein
appearance.grid.borderColor	Text	Nein
appearance.grid.borderStyle	einer der Werte; solid \| dashed \| dotted	Nein
appearance.card.bgColor	einer der Werte; Text \| transparent \| object	Nein
appearance.card.borderRadius	einer der Werte; sharp \| rounded	Nein
appearance.card.borderWidth	Zahl; Ganzzahl; mindestens 0; höchstens 3	Nein
appearance.card.borderColor	Text	Nein
appearance.header.bgColor	einer der Werte; Text \| transparent \| object	Nein
appearance.header.fontFamily	einer der Werte; sans \| serif \| handwriting \| playful \| mono	Nein
appearance.header.fontWeight	einer der Werte; normal \| medium \| semibold \| bold \| extrabold	Nein
appearance.header.color	Text	Nein
appearance.header.maxFontSize	Zahl; mindestens 6; höchstens 120	Nein
appearance.footer.enabled	wahr/falsch	Nein
appearance.footer.text	Text; höchstens 200	Nein
appearance.footer.fontFamily	einer der Werte; sans \| serif \| handwriting \| playful \| mono	Nein
appearance.footer.fontWeight	einer der Werte; normal \| medium \| semibold \| bold \| extrabold	Nein
appearance.footer.color	Text	Nein
appearance.footer.align	einer der Werte; left \| center \| right	Nein
appearance.footer.maxFontSize	Zahl; mindestens 6; höchstens 120	Nein
appearance.columnHeaders	Liste; höchstens 5	Nein
appearance.columnHeaders[]	Text; mindestens 1; höchstens 8	Nein
appearance.showColumnHeaders	wahr/falsch	Nein
appearance.randomization	einer der Werte; full \| column	Nein
appearance.freeSpaceLabel	Text; höchstens 40	Nein
appearance.signatureLines	wahr/falsch	Nein
appearance.fontFamily	einer der Werte; sans \| serif \| handwriting \| playful \| mono	Nein
appearance.fontSize	einer der Werte; small \| medium \| large	Nein
appearance.headerBgColor	Text	Nein
appearance.showGridLines	wahr/falsch	Nein
appearance.outerBorder	wahr/falsch	Nein
appearance.borderStyle	einer der Werte; solid \| dashed \| dotted	Nein
export.paperSize	einer der Werte; A3 \| A4 \| A4-landscape \| A5 \| B5 \| Letter \| Letter-landscape \| Legal \| Half-Letter \| Tabloid \| custom	Nein
export.widthMm	Zahl; mindestens 50; höchstens 2000	Nein
export.heightMm	Zahl; mindestens 50; höchstens 2000	Nein
export.unit	einer der Werte; mm \| cm \| in \| px	Nein
export.quality	einer der Werte; standard \| high \| print	Nein
export.layout	einer der Werte; 1x1 \| 1x2 \| 2x2 \| 2x4	Nein
input.words	Liste; mindestens 1; höchstens 200	Nein
input.words[]	Text; mindestens 1; höchstens 50	Nein
input.numbers	Liste	Nein
input.numbers[]	Zahl; Ganzzahl; mindestens 0; höchstens 9999	Nein
options.seed	Zahl; Ganzzahl; mindestens 0; höchstens 2147483647	Nein
options.gridSize	einer der Werte; 3 \| 4 \| 5	Nein
options.cardCount	Zahl; Ganzzahl; mindestens 1; höchstens 100	Nein
options.freeSpace	wahr/falsch	Nein
options.minNumber	Zahl; Ganzzahl; mindestens 0; höchstens 9999	Nein
options.maxNumber	Zahl; Ganzzahl; mindestens 0; höchstens 9999	Nein
options.ballCount	einer der Werte; 30 \| 75 \| 80	Nein
options.signatureLine	wahr/falsch	Nein

Vorlagen und Themen

Aktuelle Vorlagenkennungen, Themen und Kontogrenzen finden Sie unter /api/v1/capabilities. Auch eine Vorlage belegt einen Speicherplatz.

Bilder und Dateien

Bildeingaben verwenden eine zuvor hochgeladene oder importierte assetId desselben Kontos. Downloads erfolgen auf der Ergebnisseite im Browser; deren Link ist kein direkter Dateilink.

Fehlerfälle

Unbekannte Felder oder widersprüchliche Kombinationen aus type, mode und preset ergeben 422. Dasselbe gilt für Eingaben, aus denen kein vollständiges Rätsel entsteht. Formate hängen von Konfiguration und Tarif ab.