REST & SOAP API

API-Operationen

API-Standards (REST & SOAP)

Ressourcen (Kontakte, Deals, …)

REST API, modern

Die REST API folgt klaren Konventionen. JSON-Responses, HTTP-Methoden, Pagination und Filter für alle Listen.

GET, POST, PUT, DELETE für alle Ressourcen
JSON-Request und -Response
API-Key via X-API-Key Header oder Authorization: Bearer
Pagination mit page und limit
Filter für Status, Datum, Mitarbeiter

# Kontakte abrufen
GET /api/v1/contacts
  ?status=Qualifiziert
  &limit=25
  &page=1

# Deal anlegen
POST /api/v1/deals
{
  "title": "Projekt Alpha",
  "contact_id": 42,
  "value": 12500,
  "stage_id": 3
}

# Deal aktualisieren
PUT /api/v1/deals/7
{
  "value": 15000,
  "stage_id": 4
}

SOAP API, für XML-Workflows

Die SOAP 1.1 API bietet dieselbe Funktionalität über XML. Vollständiges WSDL verfügbar. Authentifizierung über SOAP-Header.

SOAP 1.1 / WSDL 1.1, document/literal
29 Operationen identisch zur REST API
Authentifizierung über FeaviAuth SOAP-Header
WSDL unter /api/soap/service.php?wsdl
Kompatibel mit PHP SoapClient, Python zeep, .NET

<!-- SOAP Request -->
<soapenv:Envelope
  xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
  xmlns:feavi="https://feavi.de/soap/v1">
  <soapenv:Header>
    <feavi:FeaviAuth>
      <ApiKey>feavi_...</ApiKey>
    </feavi:FeaviAuth>
  </soapenv:Header>
  <soapenv:Body>
    <feavi:ListContacts>
      <page>1</page>
      <limit>25</limit>
    </feavi:ListContacts>
  </soapenv:Body>
</soapenv:Envelope>

Alle Endpunkte

Methode	Endpunkt	Beschreibung
GET	/api/v1/contacts	Kontakte auflisten (Filter, Pagination)
POST	/api/v1/contacts	Kontakt anlegen
GET	/api/v1/contacts/{id}	Kontakt abrufen
PUT	/api/v1/contacts/{id}	Kontakt aktualisieren
DELETE	/api/v1/contacts/{id}	Kontakt löschen
GET	/api/v1/deals	Deals auflisten
POST	/api/v1/deals	Deal anlegen
PUT	/api/v1/deals/{id}	Deal aktualisieren
POST	/api/v1/deals/{id}/won	Deal als gewonnen markieren
POST	/api/v1/deals/{id}/lost	Deal als verloren markieren
GET	/api/v1/appointments	Termine auflisten
POST	/api/v1/appointments	Termin anlegen
GET	/api/v1/projects	Projekte auflisten
POST	/api/v1/projects	Projekt anlegen
GET	/api/v1/projects/{id}/tasks	Aufgaben eines Projekts
POST	/api/v1/activities	Aktivität protokollieren

Vollständige REST Dokumentation →

API-Key Authentifizierung

Jede API-Anfrage wird über einen API-Key authentifiziert. Keys können in den Einstellungen erstellt, mit Namen versehen und bei Bedarf deaktiviert werden.

SHA-256 gehashte Keys in der Datenbank
Keys mit Ablaufdatum konfigurierbar
Einzelne Keys können sofort deaktiviert werden
Last-Used-Tracking pro Key
Team-Isolation: jeder Key sieht nur Team-Daten

# REST: Header-Varianten

X-API-Key: feavi_dein_key

Authorization: Bearer feavi_dein_key

# SOAP: Header-Variante

<FeaviAuth>
  <ApiKey>feavi_dein_key</ApiKey>
</FeaviAuth>

# Neuen Key erstellen (REST)
POST /api/v1/keys
{
  "name": "Mein Integration Key",
  "expires_at": "2026-12-31"
}

FEAVI, programmierbar

REST API, modern

SOAP API, für XML-Workflows

Alle Endpunkte

API-Key Authentifizierung

API-Dokumentation lesen