API Ordinavo Connect

URL de base

L’URL de base finale est fournie selon l’environnement et le tenant. La documentation utilise une URL d’aperçu pour les exemples.

https://api.ordinavo.de/connect/v1

Quickstart

1. Recevoir les identifiants d’accès
2. S’authentifier
3. Créer une demande de rendez-vous
4. Enregistrer l’identifiant de la demande
5. Lire le statut ou recevoir un webhook

Beispiel: Erste Terminanfrage

POST /connect/v1/appointment-requests
Authorization: Bearer {access_token}
Content-Type: application/json
Idempotency-Key: 7b56e4c2-2e7a-4b7c-bf44-291d2c9d1f91

{
  "externalReference": "REQ-2026-000184",
  "serviceType": "maintenance_visit",
  "priority": "normal",
  "customer": {
    "name": "Muster GmbH",
    "contactName": "Max Mustermann",
    "email": "max.mustermann@example.com",
    "phone": "+49 201 000000"
  },
  "location": {
    "street": "Musterstrasse 12",
    "postalCode": "45127",
    "city": "Essen",
    "country": "DE"
  },
  "preferredTimeWindows": [
    {
      "date": "2026-06-22",
      "from": "09:00",
      "to": "12:00",
      "timeZone": "Europe/Berlin"
    }
  ],
  "description": "Wartungstermin fuer Anlage im Eingangsbereich.",
  "metadata": {
    "source": "customer_portal",
    "terminalId": "terminal-essen-01"
  }
}

Exemple de réponse

{
  "id": "apr_01JZ7YQ1H7MP6Q5V8N9D4G3A2B",
  "status": "Submitted",
  "externalReference": "REQ-2026-000184",
  "createdAt": "2026-06-15T14:30:00Z",
  "links": {
    "self": "/connect/v1/appointment-requests/apr_01JZ7YQ1H7MP6Q5V8N9D4G3A2B",
    "status": "/connect/v1/appointment-requests/apr_01JZ7YQ1H7MP6Q5V8N9D4G3A2B/status"
  }
}