FEAVI REST API v1

Vollständige REST-Schnittstelle für FEAVI CRM. Damit kannst du Kontakte, Deals, Termine, Projekte und Aktivitäten aus externen Tools (Zapier, Make, eigene Apps, Scripts) lesen, erstellen, bearbeiten und löschen.

Setup & Erste Schritte

Schritt 1 — Migration ausführen

Ruf die Migration einmalig im Browser auf. Damit wird die Tabelle für API-Keys angelegt.

https://feavi.com/migrate_api_keys.php

Schritt 2 — Ersten API-Key erstellen

Füge direkt in der Datenbank einen initialen Key ein (nur beim allerersten Mal). Danach kannst du über die API weitere Keys erzeugen.

-- In phpMyAdmin oder deinem DB-Tool ausführen:
INSERT INTO Sandeck_crm_api_keys (team_id, user_id, name, key_prefix, key_hash)
VALUES (
  1,                                         -- deine team_id
  1,                                         -- deine user_id
  'Mein erster Key',
  'feavi_boot',
  SHA2('feavi_MEIN_GEHEIMER_KEY_HIER', 256)
);

Schritt 3 — Verbindung testen

curl -H "X-API-Key: feavi_MEIN_GEHEIMER_KEY_HIER" \
     https://feavi.com/api/v1
# Antwort:
{
  "api": "FEAVI REST API",
  "version": "v1",
  "team_id": 1,
  "resources": [ ... ]
}

Schritt 4 — Produktions-Key generieren

curl -X POST https://feavi.com/api/v1/keys \
     -H "X-API-Key: feavi_MEIN_GEHEIMER_KEY_HIER" \
     -H "Content-Type: application/json" \
     -d '{"name": "Zapier Integration"}'

# Antwort — Key nur einmal sichtbar:
{
  "success": true,
  "id": 2,
  "api_key": "feavi_a1b2c3d4e5f6...",
  "warning": "Speichere diesen Key – er wird nicht erneut angezeigt!"
}

Authentifizierung

Jede Anfrage muss einen gültigen API-Key mitschicken. Es gibt drei gleichwertige Möglichkeiten:

Option A — X-API-Key Header (empfohlen)

curl https://feavi.com/api/v1/contacts \
     -H "X-API-Key: feavi_dein_key_hier"

Option B — Authorization Bearer

curl https://feavi.com/api/v1/contacts \
     -H "Authorization: Bearer feavi_dein_key_hier"

Option C — Query-Parameter (nur zum Testen)

https://feavi.com/api/v1/contacts?api_key=feavi_dein_key_hier

Key-Format

Alle Keys beginnen mit feavi_ gefolgt von 40 zufälligen Hex-Zeichen. Jeder Key ist einem Team zugeordnet — du siehst nur Daten deines Teams.

Antwort-Format

Alle Antworten sind JSON mit UTF-8-Kodierung. Das Basis-Feld success zeigt ob die Anfrage erfolgreich war.

Einzelnes Objekt

{
  "success": true,
  "data": {
    "id": 42,
    "first_name": "Max",
    "last_name": "Mustermann",
    ...
  }
}

Liste (paginiert)

{
  "success": true,
  "data": [ /* Array von Objekten */ ],
  "meta": {
    "total":  247,    // Gesamtanzahl (ohne Limit)
    "limit":  50,     // Aktuelle Seitengroesse
    "offset": 0      // Aktueller Startpunkt
  }
}

Erstellt (201)

{
  "success": true,
  "id": 123   // ID des neuen Eintrags
}

Fehler

{
  "success": false,
  "error": "Kontakt nicht gefunden"
}

Filter & Pagination

Alle Listen-Endpunkte (GET /{resource}) akzeptieren diese Standard-Parameter:

Beispiel: Seite 3 mit je 20 Einträgen

https://feavi.com/api/v1/contacts?limit=20&offset=40

Nächste Seite berechnen

// Pseudo-Code
offset = 0
limit  = 50

while (offset < meta.total) {
    fetch(`/contacts?limit=${limit}&offset=${offset}`)
    offset += limit
}

HTTP-Statuscodes

Kontakte

Kunden, Leads und alle anderen Kontakte. Basis-URL: https://feavi.com/api/v1/contacts

curl "https://feavi.com/api/v1/contacts?search=Müller&status=kunde&limit=25" \
     -H "X-API-Key: feavi_..."

curl "https://feavi.com/api/v1/contacts/42" \
     -H "X-API-Key: feavi_..."

# Antwort
{
  "success": true,
  "data": { "id": 42, "first_name": "Max", ... },
  "deals": [ ... ],
  "activities": [ ... ]
}

curl -X POST "https://feavi.com/api/v1/contacts" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{
       "first_name": "Anna",
       "last_name":  "Müller",
       "email":      "anna@example.com",
       "phone":      "+49 89 123456",
       "company":    "Muster GmbH",
       "status":     "neu"
     }'

# Antwort 201
{ "success": true, "id": 123 }

curl -X PUT "https://feavi.com/api/v1/contacts/42" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{"status": "kunde", "notes": "Vertrag unterschrieben"}'

curl -X DELETE "https://feavi.com/api/v1/contacts/42" \
     -H "X-API-Key: feavi_..."

Deals

Verkaufschancen in den Sales-Pipelines. Basis-URL: https://feavi.com/api/v1/deals

curl "https://feavi.com/api/v1/deals?pipeline_id=1&status=open&value_min=5000" \
     -H "X-API-Key: feavi_..."

curl -X POST "https://feavi.com/api/v1/deals" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{
       "title":       "Enterprise-Paket Muster GmbH",
       "pipeline_id": 1,
       "stage_id":    3,
       "value":       12000,
       "contact_id":  42
     }'

# Stage verschieben
curl -X PUT "https://feavi.com/api/v1/deals/7" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{"stage_id": 5}'

curl -X POST "https://feavi.com/api/v1/deals/7/won" \
     -H "X-API-Key: feavi_..."

curl -X POST "https://feavi.com/api/v1/deals/7/lost" \
     -H "X-API-Key: feavi_..."

curl -X DELETE "https://feavi.com/api/v1/deals/7" \
     -H "X-API-Key: feavi_..."

Termine

Gebuchte Termine (Appointments). Basis-URL: https://feavi.com/api/v1/appointments

curl "https://feavi.com/api/v1/appointments?date_from=2025-06-01&date_to=2025-06-30&status=active" \
     -H "X-API-Key: feavi_..."

curl -X POST "https://feavi.com/api/v1/appointments" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{
       "type_id":      1,
       "staff_user_id": 3,
       "start_at":     "2025-06-15 10:00:00",
       "guest_name":   "Max Mustermann",
       "guest_email":  "max@example.com",
       "guest_phone":  "+49 89 123456"
     }'

curl -X DELETE "https://feavi.com/api/v1/appointments/5" \
     -H "X-API-Key: feavi_..."

Projekte & Aufgaben

Projekt-Management inkl. Aufgaben. Basis-URL: https://feavi.com/api/v1/projects

curl "https://feavi.com/api/v1/projects?status=active&priority=high" \
     -H "X-API-Key: feavi_..."

curl "https://feavi.com/api/v1/projects/5" \
     -H "X-API-Key: feavi_..."

# Antwort
{
  "success": true,
  "data":    { "id": 5, "name": "Website-Relaunch", ... },
  "tasks":   [ { "id": 11, "title": "Design Mockup", "status": "in_progress" }, ... ]
}

curl -X POST "https://feavi.com/api/v1/projects/5/tasks" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{
       "title":       "Design Mockup erstellen",
       "priority":    "high",
       "deadline":    "2025-06-30",
       "assigned_to": 2
     }'

# Aufgabe als erledigt markieren
curl -X PUT "https://feavi.com/api/v1/projects/5/tasks/11" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{"status": "done"}'

Aktivitäten

Anrufe, E-Mails, Meetings, Notizen, Aufgaben — das Aktivitäten-Log. Basis-URL: https://feavi.com/api/v1/activities

curl "https://feavi.com/api/v1/activities?contact_id=42&type=anruf" \
     -H "X-API-Key: feavi_..."

curl -X POST "https://feavi.com/api/v1/activities" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{
       "type":       "anruf",
       "subject":    "Erstgespräch geführt",
       "notes":      "Interesse an Paket M. Rückruf in 2 Wochen.",
       "contact_id": 42,
       "deal_id":    7
     }'

curl -X DELETE "https://feavi.com/api/v1/activities/99" \
     -H "X-API-Key: feavi_..."

API-Keys verwalten

Erstelle, liste und deaktiviere API-Keys deines Teams. Basis-URL: https://feavi.com/api/v1/keys

curl "https://feavi.com/api/v1/keys" \
     -H "X-API-Key: feavi_..."

# Antwort
{
  "data": [
    {
      "id":           1,
      "name":         "Zapier Integration",
      "key_prefix":   "feavi_a1b2c3",
      "last_used_at": "2025-05-20 14:30:00",
      "expires_at":   null,
      "created_at":   "2025-01-10 09:00:00"
    }
  ]
}

curl -X POST "https://feavi.com/api/v1/keys" \
     -H "X-API-Key: feavi_..." \
     -H "Content-Type: application/json" \
     -d '{"name": "Make.com Webhook", "expires_at": "2026-12-31"}'

# Antwort 201
{
  "success": true,
  "id":      3,
  "api_key": "feavi_a1b2c3d4e5f6g7h8i9j0...",
  "warning": "Speichere diesen Key – er wird nicht erneut angezeigt!"
}

curl -X DELETE "https://feavi.com/api/v1/keys/3" \
     -H "X-API-Key: feavi_..."

Beispiele aus der Praxis

Zapier / Make.com — Neuer Kontakt aus Webformular

// Webhook-Body von Zapier/Make → FEAVI
POST https://feavi.com/api/v1/contacts
{
  "first_name": "{{Vorname}}",
  "last_name":  "{{Nachname}}",
  "email":      "{{E-Mail}}",
  "company":    "{{Firma}}",
  "source":     "Website",
  "status":     "neu"
}

JavaScript — Alle offenen Deals laden

const res = await fetch('https://feavi.com/api/v1/deals?status=open&limit=100', {
  headers: { 'X-API-Key': 'feavi_...' }
});
const { data, meta } = await res.json();
console.log(`${meta.total} offene Deals geladen`);

PHP — Kontakt erstellen und Deal anlegen

$key = 'feavi_...';
$api = 'https://feavi.com/api/v1';

// 1. Kontakt anlegen
$ch = curl_init("$api/contacts");
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => ["X-API-Key: $key", 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'first_name' => 'Anna',
        'last_name'  => 'Müller',
        'email'      => 'anna@example.com',
    ]),
]);
$result = json_decode(curl_exec($ch), true);
$contact_id = $result['id'];

// 2. Deal dazu erstellen
curl_setopt($ch, CURLOPT_URL, "$api/deals");
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([
    'title'       => 'Neues Angebot Anna Müller',
    'pipeline_id' => 1,
    'stage_id'    => 1,
    'value'       => 4900,
    'contact_id'  => $contact_id,
]));
$deal = json_decode(curl_exec($ch), true);