Curenect Bestell API

Dokumentation

Diese Dokumentation beschreibt die RESTful API zur Integration des Curenect Bestellprozesses mit externen Systemen. Die vollständige API-Spezifikation ist als OpenAPI 3.0 Schema verfügbar.

OpenAPI Spezifikation herunterladen

Authentifizierung

Die API verwendet Bearer-Token-Authentifizierung mit Odoo API-Keys. Füge den Bearer-Token im Authorization-Header zu jeder Anfrage hinzu:

Authorization: Bearer YOUR_API_KEY

API-Keys können von einem Odoo-Administrator erstellt werden.

CORS-Unterstützung

Die API unterstützt vollständig CORS (Cross-Origin Resource Sharing), wodurch der Zugriff von Javascript-Anwendungen aus verschiedenen Domains möglich ist. Alle Endpunkte können direkt von Frontend-Anwendungen angesprochen werden, ohne dass ein Proxy-Server erforderlich ist.

API-Endpunkte

Endpunkt	Methode	Beschreibung
`/api/bestellungen/ik/:id`	GET	Abfrage von Bestellungen anhand der IK-Nummer im Pfad
`/api/bestellungen?ik=:id`	GET	Abfrage mit IK-Nummer als Query-Parameter
`/api/bestellung/docs`	GET	API-Dokumentation (diese Seite)
`/api/bestellung/openapi.yml`	GET	OpenAPI-Spezifikation zum Download

Beispielanfrage

# Mit curl
curl -X GET "https://your-odoo-instance.de/api/bestellungen/ik/123456789" \
     -H "Authorization: Bearer YOUR_API_KEY"

# Mit Javascript (dank CORS-Unterstützung)
fetch('https://your-odoo-instance.de/api/bestellungen/ik/123456789', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
})
.then(response => response.json())
.then(data => console.log(data));

Beispielantwort

{
  "data": [
    {
      "id": 1234,
      "order_number": "SO0001",
      "status": "confirmed"
    }
  ]
}

Fehlercodes

Code	Beschreibung
400	Ungültige Anfrage (z.B. fehlende erforderliche Parameter)
401	Nicht authentifiziert (ungültiger oder fehlender API-Key)
404	Ressource nicht gefunden
500	Serverfehler

Support

Bei Fragen oder Problemen wenden Sie sich bitte an den Support: [email protected]