Kartu bingo Rujukan API
Kartu bingo: Rujukan ini membaca mode, prasetel, format, dan kolom dari daftar serta kontrak masukan yang sama dengan API.
Contoh permintaan
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 } }'Mode
classic ยท signature ยท number ยท blank
Prasetel halaman
Format ekspor di peramban
pdf ยท caller-pdf
Format bergantung pada pengaturan dan paket akun. viewUrl dan exportPageUrl membuka unduhan di peramban; respons tidak berisi berkas PDF, PNG, atau STL. Hak ekspor ditetapkan saat diterbitkan dan diperiksa lagi ketika diterbitkan ulang.
Kolom umum
| Kolom | Nilai yang diterima | Wajib |
|---|---|---|
| preset | teks | Tidak |
| mode | teks | Tidak |
| locale | salah satu; en | zh | es | de | fr | pt | it | id | ja | ko | Tidak |
| contentLanguage | salah satu; en | zh | es | de | fr | pt | it | id | ja | ko | Tidak |
| title | teks | Ya |
| retentionDays | angka; bilangan bulat | Tidak |
| appearance.themeColor | teks | Tidak |
| appearance.title.fontFamily | salah satu; sans | serif | handwriting | playful | mono | Tidak |
| appearance.title.fontWeight | salah satu; normal | medium | semibold | bold | extrabold | Tidak |
| appearance.title.color | teks | Tidak |
| appearance.title.align | salah satu; left | center | right | Tidak |
| appearance.title.maxFontSize | angka; minimum 6; maksimum 120 | Tidak |
| appearance.grid.shape | salah satu; square | circle | Tidak |
| appearance.grid.corners | salah satu; sharp | sm | md | lg | Tidak |
| appearance.grid.gap | salah satu; none | sm | md | lg | Tidak |
| appearance.grid.colorMode | salah satu; mono | checker | Tidak |
| appearance.grid.bg | salah satu; teks | transparent | object | Tidak |
| appearance.grid.textFontFamily | salah satu; sans | serif | handwriting | playful | mono | Tidak |
| appearance.grid.textFontWeight | salah satu; normal | medium | semibold | bold | extrabold | Tidak |
| appearance.grid.textColor | teks | Tidak |
| appearance.grid.borderWidth | angka; bilangan bulat; minimum 0; maksimum 3 | Tidak |
| appearance.grid.borderColor | teks | Tidak |
| appearance.grid.borderStyle | salah satu; solid | dashed | dotted | Tidak |
| appearance.card.bgColor | salah satu; teks | transparent | object | Tidak |
| appearance.card.borderRadius | salah satu; sharp | rounded | Tidak |
| appearance.card.borderWidth | angka; bilangan bulat; minimum 0; maksimum 3 | Tidak |
| appearance.card.borderColor | teks | Tidak |
| appearance.header.bgColor | salah satu; teks | transparent | object | Tidak |
| appearance.header.fontFamily | salah satu; sans | serif | handwriting | playful | mono | Tidak |
| appearance.header.fontWeight | salah satu; normal | medium | semibold | bold | extrabold | Tidak |
| appearance.header.color | teks | Tidak |
| appearance.header.maxFontSize | angka; minimum 6; maksimum 120 | Tidak |
| appearance.footer.enabled | benar/salah | Tidak |
| appearance.footer.text | teks; maksimum 200 | Tidak |
| appearance.footer.fontFamily | salah satu; sans | serif | handwriting | playful | mono | Tidak |
| appearance.footer.fontWeight | salah satu; normal | medium | semibold | bold | extrabold | Tidak |
| appearance.footer.color | teks | Tidak |
| appearance.footer.align | salah satu; left | center | right | Tidak |
| appearance.footer.maxFontSize | angka; minimum 6; maksimum 120 | Tidak |
| appearance.columnHeaders | daftar; maksimum 5 | Tidak |
| appearance.columnHeaders[] | teks; minimum 1; maksimum 8 | Tidak |
| appearance.showColumnHeaders | benar/salah | Tidak |
| appearance.randomization | salah satu; full | column | Tidak |
| appearance.freeSpaceLabel | teks; maksimum 40 | Tidak |
| appearance.signatureLines | benar/salah | Tidak |
| appearance.fontFamily | salah satu; sans | serif | handwriting | playful | mono | Tidak |
| appearance.fontSize | salah satu; small | medium | large | Tidak |
| appearance.headerBgColor | teks | Tidak |
| appearance.showGridLines | benar/salah | Tidak |
| appearance.outerBorder | benar/salah | Tidak |
| appearance.borderStyle | salah satu; solid | dashed | dotted | Tidak |
| export.paperSize | salah satu; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | custom | Tidak |
| export.widthMm | angka; minimum 50; maksimum 2000 | Tidak |
| export.heightMm | angka; minimum 50; maksimum 2000 | Tidak |
| export.unit | salah satu; mm | cm | in | px | Tidak |
| export.quality | salah satu; standard | high | print | Tidak |
| export.layout | salah satu; 1x1 | 1x2 | 2x2 | 2x4 | Tidak |
| input.words | daftar; minimum 1; maksimum 200 | Tidak |
| input.words[] | teks; minimum 1; maksimum 50 | Tidak |
| input.numbers | daftar | Tidak |
| input.numbers[] | angka; bilangan bulat; minimum 0; maksimum 9999 | Tidak |
| options.seed | angka; bilangan bulat; minimum 0; maksimum 2147483647 | Tidak |
| options.gridSize | salah satu; 3 | 4 | 5 | Tidak |
| options.cardCount | angka; bilangan bulat; minimum 1; maksimum 100 | Tidak |
| options.freeSpace | benar/salah | Tidak |
| options.minNumber | angka; bilangan bulat; minimum 0; maksimum 9999 | Tidak |
| options.maxNumber | angka; bilangan bulat; minimum 0; maksimum 9999 | Tidak |
| options.ballCount | salah satu; 30 | 75 | 80 | Tidak |
| options.signatureLine | benar/salah | Tidak |
Templat dan tema
Periksa /api/v1/capabilities untuk daftar templat, tema, dan batas akun saat ini. Memakai templat tetap menggunakan satu jatah simpan.
Gambar dan berkas
Masukan gambar memakai assetId yang diunggah atau diimpor oleh akun yang sama. Unduhan dilakukan pada halaman hasil di peramban; tautan halaman bukan tautan berkas langsung.
Kasus gagal
Kolom tidak dikenal atau gabungan type, mode, dan preset yang bertentangan menghasilkan 422. Masukan yang tidak dapat menghasilkan teka-teki lengkap juga menghasilkan 422. Format bergantung pada pengaturan dan hak akun.
