Zum Hauptinhalt springen

API-Schnellstart

Diese Anleitung führt Sie durch die Erstellung eines API-Keys und Ihre erste API-Anfrage. In weniger als 5 Minuten sind Sie startklar.

Voraussetzungen​

  • Ein aktives Pro Plan-Abonnement
  • Zugang zur docs101-Web-App

Schritt 1: API-Key erstellen​

  1. Melden Sie sich bei docs101 an und klicken Sie auf das Zahnrad-Symbol (oben rechts), um die Kontoeinstellungen zu öffnen, und wählen Sie den Tab API Keys
  2. Klicken Sie auf API Key erstellen
  3. Geben Sie einen beschreibenden Namen ein (z.B. „Meine CRM-Integration")
  4. Klicken Sie auf Erstellen
  5. Kopieren Sie den angezeigten API-Key sofort
Key sichern

Der vollständige API-Key wird nur einmal nach der Erstellung angezeigt. Kopieren Sie ihn an einen sicheren Ort. Wenn Sie ihn verlieren, müssen Sie einen neuen Key erstellen.

Ihr Key sieht so aus: ak_live_a1b2c3d4e5f6789012345678abcdef01

Schritt 2: Erste Anfrage senden​

Testen Sie Ihren API-Key, indem Sie Ihre Kunden abrufen:

curl -H "X-API-Key: ak_live_IHR_KEY_HIER" \
  https://docs101.com/api/customers/

Eine erfolgreiche Antwort liefert ein JSON-Array Ihrer Kunden:

[
  {
    "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "name": "Acme Corp",
    "email": "billing@acme.com",
    "vat_number": "DE123456789"
  }
]

Wenn Sie eine 401-Antwort erhalten, überprüfen Sie, ob Ihr API-Key korrekt und aktiv ist.

Schritt 3: API erkunden​

Öffnen Sie die Swagger-Dokumentation, um alle verfügbaren Endpunkte, Request-Parameter und Response-Schemas zu sehen. Sie können Anfragen direkt über die Swagger-Oberfläche testen.

Nächste Schritte​

  • Authentifizierung — Ausführliche Anleitung mit Python- und JavaScript-Beispielen
  • Swagger UI — Vollständige interaktive API-Referenz