Digitale Visitenkarten

API-Dokumentation

Authentifizierung

Alle API-Anfragen müssen mit einem API-Schlüssel authentifiziert werden.

Fügen Sie den Schlüssel als Bearer-Token im Authorization-Header hinzu:

Authorization: Bearer dvk_your_api_key_here

API-Schlüssel können unter Einstellungen > API-Schlüssel erstellt werden.

Endpoints

GET
/api/v1/cards

Alle Visitenkarten des Benutzers abrufen

Response:

{ "cards": [{ "id": "...", "slug": "...", "firstName": "...", "lastName": "...", ... }] }

POST
/api/v1/cards

Neue Visitenkarte erstellen

Request Body:

{ "firstName": "Max", "lastName": "Mustermann", "email": "[email protected]", ... }

Response:

{ "card": { "id": "...", ... } }

GET
/api/v1/leads

Alle Leads des Benutzers abrufen

Response:

{ "leads": [{ "id": "...", "firstName": "...", "email": "...", "status": "new", ... }] }

POST
/api/v1/leads

Neuen Lead erstellen

Request Body:

{ "firstName": "Anna", "lastName": "Müller", "email": "[email protected]" }

Response:

{ "lead": { "id": "...", ... } }

GET
/api/v1/leads/{id}

Einzelnen Lead abrufen

Response:

{ "lead": { "id": "...", "firstName": "...", "tags": [...], ... } }

PUT
/api/v1/leads/{id}

Lead aktualisieren (nur übergebene Felder; status: new | contacted | qualified | converted | archived)

Request Body:

{ "status": "qualified", "notes": "Rückruf am Montag", "tags": ["Messe 2026"] }

Response:

{ "lead": { "id": "...", ... } }

DELETE
/api/v1/leads/{id}

Lead löschen

Response:

{ "success": true }