Zum Inhalt springen
ENTWICKLER

Integrieren Sie die Service-Marketplace-API

Eine kleine, planbare REST-API: Token holen, Anfrage erstellen, Duplikate prüfen. Technische Dokumentation und Integrationsressourcen werden freigegebenen Partnern bereitgestellt.

Was ist Fixando?

Die Fixando Service-Marketplace-API ist eine REST-API, die mit OAuth 2.0 Client Credentials gesichert ist und Endpunkte zum Erstellen von Serviceanfragen und zur Duplikatsprüfung bietet. Sie ist privat, und technische Ressourcen werden ausschließlich freigegebenen Partnern zur Verfügung gestellt.

Authentifizierung

Holen Sie ein Bearer-Token am OAuth-Endpunkt über den Client-Credentials-Grant und senden Sie es im Authorization-Header jedes Aufrufs. Tokens sind kurzlebig, also serverseitig cachen und erneuern.

  • POST /oauth/token - Client-Credentials-Grant
  • POST /v1/request/create - Serviceanfrage erstellen
  • POST /v1/request/validate - Duplikate prüfen
  • Technische Dokumentation und Integrationsressourcen werden freigegebenen Partnern bereitgestellt

Eine Anfrage erstellen

Senden Sie formularkodierte Parameter mit Kategorie, Standort und Beschreibung des Bedarfs. Freigegebene Partner können statt Text auch base64-kodiertes Audio senden. Prüfen Sie zuerst auf Duplikate, wenn Ihr Ablauf Mehrfachsendungen erzeugen kann.

Best Practices

Halten Sie Partner-Zugangsdaten serverseitig, niemals im Browser oder Mobile-Bundle. Behandeln Sie Ratenlimits mit exponentiellem Backoff, protokollieren Sie zurückgegebene IDs, und betrachten Sie die Validierung als festen Bestandteil des Standardablaufs, nicht als optionalen Zusatz.

Häufige Fragen

Welchen Content-Type erwartet der Create-Endpunkt?
application/x-www-form-urlencoded, mit Bearer-Token im Authorization-Header.
Wo finde ich die vollständige Dokumentation?
Technische Dokumentation und Integrationsressourcen, einschließlich einer OpenAPI-Spezifikation und einer Postman-Sammlung, werden freigegebenen Partnern während des Onboardings direkt bereitgestellt.
Ist die OpenAPI-Spezifikation öffentlich?
Nein. Sie ist Teil unserer privaten Partnerressourcen und wird freigegebenen Partnern zusammen mit einer Postman-Sammlung bereitgestellt, um die Integration zu beschleunigen.

Starten Sie Ihre Integration

Kontaktieren Sie uns, um eine Partnerintegration zu starten. Unser Team prüft jede Integration einzeln und bespricht mit Ihnen die technischen Details.

API-Zugang anfragen

Erzählen Sie uns von Ihrem Produkt und davon, wie Sie Fixando integrieren möchten. Unser Team prüft jede Integration individuell und kontaktiert Sie, um Ihren Anwendungsfall und die technischen Anforderungen zu besprechen.

22 Märkte werden unterstützt. Die Verfügbarkeit kann je nach Servicekategorie und Standort variieren.

Unser Team prüft jede Integration individuell und kontaktiert Sie, um Ihren Anwendungsfall und die technischen Anforderungen zu besprechen.