SimplyPrintの3DプリンターAPI

1回のAPI呼び出しでプリントを開始

コードからエクストルーダーを動かすまでの最短手順です。/queue/AddItemにファイルIDをPOSTし、1台以上のプリンターを指定するだけで、あとはSimplyPrintが処理します。内部ではパネルと同じマッチング、承認、振り分けのロジックが動作するため、手動でプリントを開始した場合と同じプリンターでプリントが始まります。

curl -X POST "https://api.simplyprint.io/{companyId}/queue/AddItem" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": "abc123",
    "amount": 1,
    "for_printers": "42,43",
    "position": "top"
  }'

{
  "status": true,
  "message": null,
  "approval_status": "not_required",
  "id": 90817,
  "queue_position": 1
}

状態を取得。コマンドを送信。認証ヘッダーは共通。

1回の呼び出しですべてのプリンターを一覧表示できます。レスポンスには、パネルに表示されるものと同じプリンターオブジェクトが含まれます。ステータス、現在のジョブ、温度、装着中のフィラメントなどの情報を確認できます。

curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42 }'

curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/SendGcode" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42, "gcode": "G28 X Y" }'

パートナー連携向けOAuth2

SimplyPrintの顧客向けにサードパーティー製アプリを開発する場合は、OAuth2を使うことで、各顧客が同意画面から自身のアカウントを接続できます。共有APIキーやシークレットのコピー＆ペーストは不要です。これは公式のCura連携と同じフローで、Zapier、n8n、Make、Activepiecesなどのプラットフォーム向けパートナー連携にも提供しています。

# 1) Send the user to the consent screen
https://simplyprint.io/panel/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://your-app.example.com/callback
  &scope=printers.read+queue.write+files.read
  &state=<random>

# 2) Exchange the returned code for an access token
curl -X POST "https://simplyprint.io/api/0/oauth2/Token" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://your-app.example.com/callback"

# 3) Discover the bound company, then call API as that company
curl "https://simplyprint.io/api/0/account/GetUser" \
  -H "Authorization: Bearer ACCESS_TOKEN"

完全なリファレンスはapidocs.simplyprint.ioで確認できます

すべてのエンドポイント、リクエストとレスポンスの形式、エラーコード、OAuth2フロー、スコープ一覧を掲載しています。ドキュメントはAIにも対応しており、AIが一度に読み込めるllms.txtと、カタログを利用したツールの構築に使える構造化されたapi/index.jsonを用意しています。

よくある質問