​

Schnellstart mit Firmium

​

1. Registrierung

1. Besuchen Sie das Firmium Dashboard.
2. Erstellen Sie ein neues Benutzerkonto mit Ihrer E-Mail-Adresse.
3. Bestätigen Sie Ihre E-Mail-Adresse über den zugesandten Link.

​

2. API-Key erhalten

1. Melden Sie sich im Dashboard an.
2. Navigieren Sie zu API / Schnittstelle.
3. Erstellen Sie einen neuen API-Key und kopieren Sie ihn sicher. Der vollständige Key wird nur einmal angezeigt.

Hinweis: Behandeln Sie Ihren API-Key wie ein Passwort. Geben Sie ihn nicht weiter und speichern Sie ihn sicher.

​

3. Erste API-Anfrage

​

Unternehmen suchen

curl -X POST https://www.firmium.de/api/v1/companies/search/ \
  -H "Authorization: Token Ihr_API_Key" \
  -H "Content-Type: application/json" \
  -d '{"name": "Beispiel GmbH"}'

{
  "count": 1,
  "next": null,
  "previous": null,
  "results": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Beispiel GmbH",
      "registration_number": "HRB 123456",
      "country": "DE",
      "status": "Active"
    }
  ]
}

curl https://www.firmium.de/api/v1/companies/550e8400-e29b-41d4-a716-446655440000/ \
  -H "Authorization: Token Ihr_API_Key"

​

4. Fehlerbehandlung

• 403 Forbidden: Key fehlt, ist ungültig oder widerrufen, oder Ihr Tarif enthält keinen API-Zugriff.
• 400 Bad Request: Ungültige Suchparameter.

Tipp: Prüfen Sie bei Fehlern immer die Gültigkeit Ihres Keys und Ihre Zugriffsrechte im Dashboard.

​

5. Best Practices

• Speichern Sie Ihren API-Key niemals im Quellcode oder in öffentlichen Repositories.
• Rotieren Sie API-Keys regelmäßig und löschen Sie nicht mehr benötigte Keys.
• Beachten Sie die Rate Limits der API.
• Lesen Sie die Authentifizierungsdokumentation für Details zur sicheren Nutzung.

​

Nächste Schritte

• Lesen Sie die Authentifizierung
• Lesen Sie die Einführung
• MCP-Server
• Kontaktieren Sie den Support bei Fragen oder Problemen