Quote3D ドキュメントへようこそ !⏳
Quote3D LogoQuote3Dドキュメント

3D プリント API クイックスタート

Quote3D API を5分以内にセットアップして使い始めましょう ! 外部連携を行う場合は、https://api.quote3d.com/v2 からエンドポイントを呼び出してください。以下の手順に従って、アカウントの作成、API トークンの生成、そして最初の API コールの実行を行ってください。

1

アカウントを作成

  1. Quote3D ダッシュボードにアクセスして、新しいアカウントにサインアップしてください
  2. 詳細情報で登録フォームに記入してください 詳細情報で登録フォームに記入してください
  3. メールを確認し、確認リンクをクリックしてアカウントを完全に有効化してください メールを確認し、確認リンクをクリックしてアカウントを完全に有効化してください

メールアドレスを確認しないと、アカウントが完全に有効化されず、API にアクセスできなくなります !

2

API トークンを生成する

  1. Quote3D アカウントにログインしてください
  2. ダッシュボードに移動してください - ログイン後、自動的にリダイレクトされます
  3. 左側のサイドバーにある「Tokens」タブをクリックしてください 左側のサイドバーにある「Tokens」タブをクリックしてください
  4. 「New Token」ボタンをクリックして新しいトークンを作成してください
  5. トークンを設定してください
    • わかりやすい名前を付けてください (例: " 最初のトークン ")
    • 有効期限を日数で設定してください (期限を設定しない場合は空白にしてください)
  6. 生成されたトークンをすぐにコピーして安全な場所に保管してください 生成されたトークンをすぐにコピーして安全な場所に保管してください

トークンは一度しか表示されません ! ポップアップを閉じる前に、必ずコピーして安全な場所に保存してください。

3

API 認証を行う

  1. /docs/playground にある API プレイグラウンドに移動してください
  2. 右上にある鍵のアイコンをクリックしてください 右上にある鍵のアイコンをクリックしてください
  3. ステップ2で取得した JWT トークンを認証フィールドに貼り付けてください
  4. 承認 Authorize

認証完了 !Quote3D API の探索を開始できます。

4

最初の API 呼び出しを行う

テストの準備はできましたか ? 最初の STL ファイルをアップロードしてみてください:

  1. API ドキュメントで POST https://api.quote3d.com/v2/file エンドポイントを探してください
  2. タブを展開して POST リクエストの詳細を表示します
  3. 「ファイルを選択」ボタンを使用して STL ファイルをアップロードし、ファイルエクスプローラーを開きます
  4. リクエストを実行します リクエストを実行します

レスポンスには、以下の用途に使用できるファイル ID が含まれます:

  • 寸法と造形可能性の確認
  • 自動インスタント価格見積もり用の見積もりを生成する
  • クラウドストレージに保存するためにアップロードされたファイルを管理する

file_id は、後続の API 呼び出しでアップロードされたファイルを管理および参照するためのキーとして機能します。これは、他のすべての API 呼び出しの起点となる一意の識別子です。

エンドポイント決定木

https://api.quote3d.com/v2 において、次に呼び出すエンドポイントを決定する際にこのクイックパスを使用してください。

  1. バックエンドからアップロードする必要がありますか ? Bearer トークンを使用して、POST https://api.quote3d.com/v2/file を使用してください。
  2. トークンを露出させずに、ブラウザから直接アップロードする必要がありますか ? GET https://api.quote3d.com/v2/file/upload-id からアップロード ID を取得し、次に POST https://api.quote3d.com/v2/file/public/{upload_id} を使用してアップロードします。
  3. 見積もり前にサイズ / 適合性の検証が必要ですか ? POST https://api.quote3d.com/v2/printability/{file_id} を呼び出します。
  4. 見積もりが必要ですか ? POST https://api.quote3d.com/v2/file/quote/{file_id} から開始してください。
  5. 見積もりの完了を待機していますか ? ステータスが completed、failed、cancelled のいずれかになるまで GET https://api.quote3d.com/v2/jobs/{job_id} をポーリングしてください。ステータス値は小文字で、失敗したジョブでも HTTP 200を返します。
  6. 保存された見積履歴や詳細が必要ですか ? GET https://api.quote3d.com/v2/quotes および GET https://api.quote3d.com/v2/quotes/{quote_id} を使用します。

注意: 見積依頼時に技術、プリンター、または材料の詳細を送信しない場合、API はデフォルトのユーザープロファイル設定にフォールバックします。

よくあるエラーと次に取るべき対応

最も一般的なエッジケースへの迅速な対処方法。

429レート制限: X-RateLimit-* および Retry-After ヘッダーを読み取り、待機した後、指数バックオフを用いて再試行してください。

無効なファイル形式: STL、3MF、OBJ、または STEP (.step/.stp) ファイルのみをアップロードしてください。モデルを再エクスポートし、ファイルの整合性を確認してください。

モデルがベッドに収まりません: 最初に造形可能性チェックを実行するか、モデルのスケールを縮小するか、より大きなプリンタープロファイルまたはビルドボリュームを選択してください。

単位の異常に関する警告: モデルがインチまたはメートル単位のスケールを使用している可能性があります。ミリメートル (mm) で再エクスポートして、再度お試しください。

次は何をしますか ?

セットアップが完了したので、これらの主要な機能をご覧ください。

  • ファイル管理 - 3D モデルファイル (STL、3MF、OBJ、STEP) をアップロード、ダウンロード、管理します。
  • プリント可能性チェック - モデルがプリンターの寸法に適合するかどうかを確認します。
  • 見積もり生成 - 詳細な材料使用量とプリント時間を見積もった、希望の通貨での即時価格を取得します。
  • 見積もり履歴 - 過去の見積もりをすべてアクセスして管理します。
  • Webhook - 見積もりの完了とファイルのアップロードに関するリアルタイム通知を受信します。
  • 分析 - 使用状況、人気のある材料、コストの傾向を追跡します。
  • アカウント管理 - クォータ、使用状況統計、サブスクリプションの詳細を監視します。

次に読むもの

重要: すべてのエンドポイントに API トークンが必要です。Authorization: Bearer TOKEN または X-API-Token: TOKEN として送信してください。唯一の例外は POST /v2/file/public/{upload_id} で、ブラウザーからのアップロードはトークンの代わりに使い捨てのアップロード ID を使います。

例: Authorization: Bearer YOUR_TOKEN_HERE

ヘルプが必要ですか ?Core Concepts ガイドを確認するか、インタラクティブなドキュメントについては API Playground をご覧ください。