REST-API (Add-on)¶

Nuka

Die Entwickler-API ist ein zubuchbares Add-on (9,90 €/Monat) und gibt programmatischen Zugriff auf Firmen, Leads, Kontakte, Ansprechpartner und Deals — inklusive Register-/GLEIF-Anreicherung, Verflechtungsdaten und Firmensuche.

Buchen & Schlüssel¶

Menü Entwickler-API (oder Preise-Seite) → „Buchen" → Stripe-Checkout.
Nach der Buchung erscheinen die Reiter API-Schlüssel und Dokumentation.
Unter API-Schlüssel erstellen Sie einen Schlüssel (wt_live_…). Er wird nur einmal angezeigt — sofort kopieren. Schlüssel lassen sich jederzeit widerrufen.

Authentifizierung¶

Jede Anfrage trägt den Schlüssel im Header:

Authorization: Bearer wt_live_…

Basis-URL: https://app.wolfstrail-crm.de/functions/v1/api

Jeder Schlüssel ist an genau einen Workspace gebunden. Limit: 10.000 Anfragen/Tag.

Ressourcen¶

companies, leads, contacts, people, deals — jeweils:

Methode	Pfad	Zweck
`GET`	`/{ressource}`	auflisten (`?limit`, `?offset`, `?q` + Feld-Filter)
`GET`	`/{ressource}/{id}`	einzeln abrufen
`POST`	`/{ressource}`	anlegen
`PATCH`	`/{ressource}/{id}`	ändern
`DELETE`	`/{ressource}/{id}`	löschen

people sind die Ansprechpartner (Organvertreter aus dem Register und angereicherte Personen). Über entity_type=company|lead und entity_id gehören sie zu einer Firma bzw. einem Lead. Filter: ?entity_id=…, ?entity_type=company, ?is_primary=true.

Verflechtungs- und Registerfelder¶

GET auf companies und leads liefert den vollständigen Datensatz, einschließlich der systemseitig gepflegten Felder:

officers — Organvertreter (Name, Rolle, Ort, seit)
shareholders — direkte Gesellschafter (Name, Anteil, Registernummer)
ownership_tree — mehrstufiger Konzernbaum (verschachtelt)
subsidiaries — Töchter aus GLEIF (Name, LEI, Ort, Land)
ultimate_parent — oberste Konzernmutter (GLEIF)
lei, registry_status, legal_form, share_capital, vat_id, financials

Filter¶

Jede Liste akzeptiert Exakt-Filter als Query-Parameter, z. B. companies?city=Düsseldorf&watched=true, leads?quality=hot, people?entity_id=….

Aktionen¶

Methode	Pfad	Zweck
`POST`	`/enrich`	Firma/Lead anreichern — Body `{ "company_id": "…" }` oder `{ "lead_id": "…" }`, optional `{ "sources": ["webscraper","register","gleif"] }`
`POST`	`/search`	Firmensuche — Body `{ "industry", "city", "radius", "maxResults", "nationwide" }`
`GET`	`/openapi.json`	vollständige OpenAPI-3.0-Spezifikation

Mit sources: ["register","gleif"] stößt enrich die Verflechtungs-Auffrischung gezielt an (Handelsregister-Gesellschafter + GLEIF-Töchter/-Konzernmutter). Die aktualisierten Werte stehen anschließend an den Feldern des Datensatzes (GET); die Antwort enthält zusätzlich ein ownership-Objekt mit dem Ergebnis.

Beispiele¶

# Firmen auflisten
curl -H "Authorization: Bearer wt_live_…" \
  "https://app.wolfstrail-crm.de/functions/v1/api/companies?limit=20"

# Lead anlegen
curl -X POST -H "Authorization: Bearer wt_live_…" -H "content-type: application/json" \
  -d '{"company_name":"Muster GmbH","phone":"0211 12345"}' \
  "https://app.wolfstrail-crm.de/functions/v1/api/leads"

# Ansprechpartner einer Firma abrufen
curl -H "Authorization: Bearer wt_live_…" \
  "https://app.wolfstrail-crm.de/functions/v1/api/people?entity_type=company&entity_id=…"

# Firma anreichern (Website)
curl -X POST -H "Authorization: Bearer wt_live_…" -H "content-type: application/json" \
  -d '{"company_id":"…"}' \
  "https://app.wolfstrail-crm.de/functions/v1/api/enrich"

# Verflechtung auffrischen (Register + GLEIF)
curl -X POST -H "Authorization: Bearer wt_live_…" -H "content-type: application/json" \
  -d '{"company_id":"…","sources":["register","gleif"]}' \
  "https://app.wolfstrail-crm.de/functions/v1/api/enrich"

Interaktive Doku¶

Im Reiter Dokumentation ist die vollständige OpenAPI-Spezifikation interaktiv eingebunden (Redoc). Die Spec liegt zusätzlich unter /openapi.json zum Download.