Skip to content
PuzzleGenio - 無料パズル作成ツール
PuzzleGenio

迷路 API 資料

迷路: この資料のモード、ページ設定、出力形式、項目は API と共通の登録情報と入力規則から取得しています。

APIキー

リクエスト例

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

モード

normal

ページ別の設定

ブラウザーでの出力形式

pdf · svg · png

出力形式はパズルの設定と契約で決まります。viewUrl と exportPageUrl はブラウザーでのダウンロード先です。応答に PDF、PNG、STL のファイル本体は含まれません。出力権限は公開時に確定し、再公開時に確認し直します。

共通の入力項目

項目指定できる値必須
preset文字列いいえ
mode文字列いいえ
localeいずれか; en | zh | es | de | fr | pt | it | id | ja | koいいえ
contentLanguageいずれか; en | zh | es | de | fr | pt | it | id | ja | koいいえ
title文字列はい
retentionDays数値; 整数いいえ
appearance.wallColor文字列いいえ
appearance.wallStrokeWidth数値; 最小 0.1; 最大 20いいえ
appearance.backgroundColor文字列いいえ
appearance.startEndMarkerいずれか; arrow | text | 数値 | noneいいえ
appearance.startEndLabelColor文字列いいえ
appearance.answerPathColor文字列いいえ
appearance.answerPathWidth数値; 最小 0.1; 最大 20いいえ
appearance.cornerStyleいずれか; sharp | roundedいいえ
export.paperSizeいずれか; A3 | A4 | A4-landscape | A5 | B5 | Letter | Letter-landscape | Legal | Half-Letter | Tabloid | customいいえ
export.widthMm数値; 最小 50; 最大 2000いいえ
export.heightMm数値; 最小 50; 最大 2000いいえ
export.unitいずれか; mm | cm | in | pxいいえ
export.qualityいずれか; standard | high | printいいえ
options.seed数値; 整数; 最小 0; 最大 2147483647いいえ
options.cols数値; 整数; 最小 5; 最大 200いいえ
options.rows数値; 整数; 最小 5; 最大 200いいえ
options.algorithmいずれか; backtracker | prim | kruskalいいえ
options.difficultyいずれか; kids | easy | medium | hard | impossibleいいえ
options.startPosition文字列いいえ
options.endPosition文字列いいえ

テンプレートとテーマ

利用可能なテンプレート番号、テーマ、アカウントの制限は /api/v1/capabilities で確認してください。テンプレートを使った結果も保存枠を一つ使います。

画像とファイル

画像には、同じアカウントで事前に送信または取り込んだ assetId を指定します。ダウンロードはブラウザーの結果ページから行います。結果ページの URL はファイルへの直接リンクではありません。

失敗する場合

未知の項目や type、mode、preset の矛盾は 422 です。完成できない入力も 422 です。出力形式は設定とアカウントの権限で変わります。

迷路 API 資料