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

クイックスタートガイド 🚀

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

1

アカウントを作成

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

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

2

APIトークンを生成する

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

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

3

API認証を行う

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

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

4

最初のAPI呼び出しを行う

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

  1. APIドキュメントで POST https://api.quote3d.com/v2/file エンドポイントを探してください
  2. タブを展開してPOSTリクエストの詳細を表示します タブを展開してPOSTリクエストの詳細を表示します
  3. 「ファイルを選択」ボタンを使用してSTLファイルをアップロードし、ファイルエクスプローラーを開きます 「ファイルを選択」ボタンを使用して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} をポーリングします。
  6. 保存された見積履歴や詳細が必要ですか？ GET https://api.quote3d.com/v2/quotes および GET https://api.quote3d.com/v2/quotes/{quote_id} を使用します。

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

Common Errors and What To Do Next

Fast actions for the most common edge cases.

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

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

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

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

次は何をしますか？

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

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

重要：すべてのAPIエンドポイントでは、Bearerトークンによる認証が必要です。すべてのリクエストのAuthorizationヘッダーに含めるようにしてください。

例： Authorization: Bearer YOUR_TOKEN_HERE

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