API-Dokumentation

Integrieren Sie Family-Tree.Online in Ihre Anwendungen. Unsere REST-API ermöglicht das Erstellen, Lesen und Aktualisieren von Stammbaumdaten.

Authentifizierung

Sicherer API-Zugriff

API-Schlüssel

Für den API-Zugriff benötigen Sie einen API-Schlüssel aus Ihren Kontoeinstellungen. Übergeben Sie den Schlüssel im Authorization-Header.

Authorization: Bearer YOUR_API_KEY

API-Schlüssel erhalten

1. Melden Sie sich in Ihrem Konto an
2. Gehen Sie zu "Einstellungen" → "API"
3. Erstellen Sie einen neuen API-Schlüssel
4. Kopieren Sie den Schlüssel und bewahren Sie ihn sicher auf

Stammbäume

GET
/api/v1/trees

Liste aller Stammbäume des Nutzers abrufen

limit integer optional
offset integer optional
Beispielanfrage:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Beispielantwort:
{ "data": [ { "id": 1, "name": "Familie Ivanov", "description": "Hauptstammbaum", "created_at": "2024-01-15T10:30:00Z", "updated_at": "2024-01-20T14:45:00Z" } ], "meta": { "total": 1, "limit": 20, "offset": 0 } }
POST
/api/v1/trees

Einen neuen Stammbaum erstellen

name string erforderlich
description string optional
Beispielanfrage:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Familie Petrov", "description": "Neuer Stammbaum" }'

Familienmitglieder

GET
/api/v1/trees/{tree_id}/humans

Liste aller Familienmitglieder in einem Stammbaum abrufen

tree_id integer erforderlich
search string optional
Beispielantwort:
{ "data": [ { "id": 1, "firstname": "Ivan", "secondname": "Ivanov", "birthday": "1980-05-15", "gender": "male", "is_alive": true, "created_at": "2024-01-15T10:30:00Z" } ], "meta": { "total": 1, "limit": 20, "offset": 0 } }
POST
/api/v1/trees/{tree_id}/humans

Ein neues Familienmitglied hinzufügen

firstname string erforderlich
secondname string erforderlich
birthday date optional
gender string optional

Verwandtschaftsbeziehungen

POST
/api/v1/humans/{human_id}/relationships

Eine Beziehung zwischen Verwandten anlegen

related_human_id integer erforderlich
relationship_type string erforderlich

SDKs und Bibliotheken

Fertige Bibliotheken für gängige Programmiersprachen

JavaScript/Node.js

Offizielle Bibliothek für JavaScript und Node.js. Unterstützt Browser und Serverumgebungen.

Installieren

Python

Python-Bibliothek mit Unterstützung für asynchrone Anfragen. Einfache Integration mit Django und Flask.

Installieren

PHP

PHP-Bibliothek mit Composer-Unterstützung. Kompatibel mit Laravel und Symfony.

Installieren

Ratenlimits

Limits für eine stabile API-Leistung

Anfragelimits

Kontotyp Anfragen pro Minute Anfragen pro Tag
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Häufig gestellte Fragen

Bereit für die Integration?

Holen Sie sich einen API-Schlüssel und integrieren Sie Family-Tree.Online in Ihre Anwendungen