Labirin Rujukan API

Labirin: 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": "maze", "title": "Simple maze", "options": { "cols": 10, "rows": 10, "algorithm": "backtracker" } }'

Mode

normal

Prasetel halaman

Format ekspor di peramban

pdf · svg · png

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.wallColor	teks	Tidak
appearance.wallStrokeWidth	angka; minimum 0.1; maksimum 20	Tidak
appearance.backgroundColor	teks	Tidak
appearance.startEndMarker	salah satu; arrow \| text \| angka \| none	Tidak
appearance.startEndLabelColor	teks	Tidak
appearance.answerPathColor	teks	Tidak
appearance.answerPathWidth	angka; minimum 0.1; maksimum 20	Tidak
appearance.cornerStyle	salah satu; sharp \| rounded	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
options.seed	angka; bilangan bulat; minimum 0; maksimum 2147483647	Tidak
options.cols	angka; bilangan bulat; minimum 5; maksimum 200	Tidak
options.rows	angka; bilangan bulat; minimum 5; maksimum 200	Tidak
options.algorithm	salah satu; backtracker \| prim \| kruskal	Tidak
options.difficulty	salah satu; kids \| easy \| medium \| hard \| impossible	Tidak
options.startPosition	teks	Tidak
options.endPosition	teks	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.