Willkommen zur Quote3D Dokumentation! ⏳
Quote3D LogoQuote3DDokumentation

Schnellstart-Anleitung 🚀

Starten Sie in weniger als 5 Minuten mit der Quote3D API! Rufen Sie für externe Integrationen Endpunkte unter https://api.quote3d.com/v2 auf. Folgen Sie diesen Schritten, um Ihr Konto zu erstellen, einen API-Token zu generieren und Ihre ersten API-Aufrufe zu tätigen.

1

Konto erstellen

  1. Besuchen Sie das Quote3D Dashboard, um sich für ein neues Konto anzumelden
  2. Füllen Sie das Registrierungsformular mit Ihren Angaben aus
  3. Überprüfen Sie Ihre E-Mail und klicken Sie auf den Bestätigungslink, um Ihr Konto vollständig zu aktivieren

Stellen Sie sicher, dass Sie Ihre E-Mail-Adresse bestätigen, da Ihr Konto sonst nicht vollständig aktiviert wird und Sie nicht auf die API zugreifen können!

2

Generieren Sie Ihr API-Token

  1. Melden Sie sich in Ihrem Quote3D-Konto an
  2. Navigieren Sie zum Dashboard – Sie werden nach der Anmeldung automatisch hierher weitergeleitet
  3. Klicken Sie auf den Reiter „Tokens“ in der linken Seitenleiste
  4. Erstellen Sie ein neues Token, indem Sie auf die Schaltfläche „Neues Token“ klicken
  5. Konfigurieren Sie Ihr Token
    • Geben Sie ihm einen beschreibenden Namen (z.B. „Mein erstes Token“)
    • Legen Sie die Gültigkeitsdauer in Tagen fest (lassen Sie das Feld leer, um keine Ablaufzeit festzulegen)
  6. Kopieren Sie das generierte Token sofort und speichern Sie es sicher

Sie sehen das Token nur einmal! Stellen Sie sicher, dass Sie es kopieren und an einem sicheren Ort speichern, bevor Sie das Popup-Fenster schließen.

3

Authentifizieren Sie sich mit der API

  1. Navigieren Sie zum API-Spielplatz unter /docs/playground
  2. Klicken Sie auf das Schloss-Symbol oben rechts
  3. Fügen Sie Ihr JWT-Token aus Schritt 2 in das Autorisierungsfeld ein
  4. Klicken Authorize

🎉 Herzlichen Glückwunsch! Sie sind jetzt authentifiziert und bereit, die Quote3D API zu erkunden.

4

Machen Sie Ihren ersten API-Aufruf

Sind Sie bereit, es auszuprobieren? Laden Sie Ihre erste STL-Datei hoch:

  1. Finden Sie den POST-Endpunkt https://api.quote3d.com/v2/file in der API-Dokumentation
  2. Erweitern Sie die Registerkarte, um die Details der POST-Anfrage anzuzeigen
  3. Laden Sie eine STL-Datei mit der Schaltfläche "Datei auswählen" hoch, um Ihren Datei-Explorer zu öffnen
  4. Führen Sie die Anfrage aus

Die Antwort enthält eine Dateikennung, die Sie für Folgendes verwenden können:

  • Überprüfung der Abmessungen und der Druckbarkeit
  • Erstellung von Angeboten für automatisierte, sofortige Preisberechnungen
  • Verwaltung der hochgeladenen Datei, um Speicherplatz in Ihrem Cloud-Speicher zu sparen

Die `file_id` dient als Ihr Schlüssel zur Verwaltung und Referenzierung Ihrer hochgeladenen Dateien in nachfolgenden API-Aufrufen. Sie ist der eindeutige Bezeichner, von dem alle anderen API-Aufrufe ausgehen.

Endpoint-Entscheidungsbaum

Verwenden Sie diesen schnellen Pfad, um zu entscheiden, welchen Endpunkt Sie als Nächstes auf https://api.quote3d.com/v2 aufrufen sollen.

  1. Müssen Sie über Ihr Backend hochladen? Verwenden Sie POST https://api.quote3d.com/v2/file mit Ihrem Bearer-Token.
  2. Benötigen Sie einen direkten Browser-Upload, ohne Ihr Token preiszugeben? Rufen Sie eine Upload-ID über GET https://api.quote3d.com/v2/file/upload-id ab und laden Sie diese anschließend mit POST https://api.quote3d.com/v2/file/public/{upload_id} hoch.
  3. Benötigen Sie eine Größen-/Passform-Validierung vor der Preisermittlung? Rufe POST https://api.quote3d.com/v2/printability/{file_id} auf.
  4. Benötigen Sie ein Angebot? Beginnen Sie mit POST https://api.quote3d.com/v2/file/quote/{file_id}.
  5. Warten auf Abschluss des Angebots? Poll GET https://api.quote3d.com/v2/jobs/{job_id} bis COMPLETED, FAILED oder CANCELLED.
  6. Benötigen Sie gespeicherte Angebotsverläufe/-details? Verwenden Sie GET https://api.quote3d.com/v2/quotes und GET https://api.quote3d.com/v2/quotes/{quote_id}.

Hinweis: Wenn Sie keine Details zu Technologie, Drucker oder Material in Angebotsanfragen senden, greift die API auf Ihre Standard-Benutzerprofileinstellungen zurück.

Häufige Fehler und die nächsten Schritte

Schnelle Maßnahmen für die häufigsten Grenzfälle.

429 Rate Limited: X-RateLimit-* und Retry-After-Header lesen, warten und dann mit exponentiellem Backoff erneut versuchen.

Ungültiges Dateiformat: Laden Sie nur STL-, 3MF- oder OBJ-Dateien hoch. Exportieren Sie das Modell erneut und überprüfen Sie die Dateiintegrität.

Modell passt nicht auf das Druckbett: Führen Sie zuerst eine Druckbarkeitprüfung durch, reduzieren Sie die Modellskalierung oder wählen Sie ein größeres Druckerprofil/Druckvolumen.

Warnung: Einheitenanomalie: Ihr Modell verwendet wahrscheinlich eine Skalierung in Zoll/Meter. Exportieren Sie es erneut in Millimetern (mm) und versuchen Sie es noch einmal.

Was kommt als Nächstes?

Jetzt, da Sie eingerichtet sind, erkunden Sie diese Schlüsselfunktionen:

  • Dateiverwaltung – Laden, Herunterladen und Verwalten Ihrer 3D-Modelldateien (STL, 3MF, OBJ)
  • Druckbarkeitsprüfung – Überprüfen Sie, ob Ihre Modelle in die Abmessungen Ihres Druckers passen
  • Kostenvoranschlagserstellung – Erhalten Sie sofortige Preise in Ihrer bevorzugten Währung mit detaillierten Materialverbrauchs- und Druckzeitschätzungen
  • Kostenvoranschlagshistorie – Greifen Sie auf alle Ihre früheren Kostenvoranschläge zu und verwalten Sie diese
  • Webhooks – Erhalten Sie Echtzeitbenachrichtigungen über den Abschluss von Kostenvoranschlägen und Datei-Uploads
  • Analyse – Verfolgen Sie Ihre Nutzung, beliebte Materialien und Kostentrends
  • Kontoverwaltung – Überwachen Sie Ihre Kontingente, Nutzungsstatistiken und Abonnementdetails

Wichtig: Alle API-Endpunkte erfordern eine Authentifizierung mit Ihrem Bearer-Token. Stellen Sie sicher, dass Sie es in den Authorization-Header jeder Anfrage einfügen.

Beispiel: Authorization: Bearer YOUR_TOKEN_HERE

Benötigen Sie Hilfe? Sehen Sie sich unsere Core Concepts-Anleitung an oder erkunden Sie den API Playground für interaktive Dokumentation.