Jigsaw Rujukan API
Jigsaw: 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": "jigsaw", "title": "Mountain puzzle", "options": { "tilesX": 5, "tilesY": 5, "shape": "rectangle" } }'Mode
normal
Prasetel halaman
Format ekspor di peramban
svg · pdf · png · dxf · zip · stl
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.lineColor | teks | Tidak |
| appearance.lineWidth | angka; minimum 0; maksimum 20 | Tidak |
| appearance.strokeOutline | benar/salah | Tidak |
| appearance.outlineColor | teks | Tidak |
| appearance.outlineWidth | angka; minimum 0; maksimum 10 | 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.thicknessMm | angka; minimum 1; maksimum 10 | Tidak |
| export.gapMm | angka; minimum 0.1; maksimum 1 | Tidak |
| input.imageAssetId | teks | Tidak |
| options.seed | angka; bilangan bulat; minimum 0; maksimum 2147483647 | Tidak |
| options.tilesX | angka; bilangan bulat; minimum 1; maksimum 100 | Tidak |
| options.tilesY | angka; bilangan bulat; minimum 1; maksimum 100 | Tidak |
| options.sizeX | angka; minimum 1; maksimum 10000 | Tidak |
| options.sizeY | angka; minimum 1; maksimum 10000 | Tidak |
| options.tabSize | angka; minimum 10; maksimum 35 | Tidak |
| options.jitter | angka; minimum 0; maksimum 10 | Tidak |
| options.cornerRadius | angka; minimum 0; maksimum 100 | Tidak |
| options.shape | teks; minimum 1; maksimum 50 | Tidak |
| options.hexRings | angka; bilangan bulat; minimum 1; maksimum 20 | 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.