API-dokumentation

Integrera Family-Tree.Online i dina applikationer. Vårt REST API låter dig skapa, läsa och uppdatera släktträdsdata.

Autentisering

Säker API-åtkomst

API-nycklar

För API-åtkomst behöver du en API-nyckel från dina kontoinställningar. Skicka nyckeln i Authorization-headern.

Authorization: Bearer YOUR_API_KEY

Skaffa en API-nyckel

1. Logga in på ditt konto
2. Gå till "Inställningar" → "API"
3. Skapa en ny API-nyckel
4. Kopiera nyckeln och förvara den säkert

Släktträd

GET
/api/v1/trees

Hämta lista över alla släktträd för användaren

limit integer valfritt
offset integer valfritt
Exempel på begäran:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Exempel på svar:
{ "data": [ { "id": 1, "name": "Familjen Ivanov", "description": "Huvudsläktträd", "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

Skapa ett nytt släktträd

name string obligatoriskt
description string valfritt
Exempel på begäran:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Familjen Petrov", "description": "Nytt släktträd" }'

Familjemedlemmar

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

Hämta lista över alla familjemedlemmar i ett träd

tree_id integer obligatoriskt
search string valfritt
Exempel på svar:
{ "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

Lägg till en ny familjemedlem

firstname string obligatoriskt
secondname string obligatoriskt
birthday date valfritt
gender string valfritt

Släktskap

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

Skapa en relation mellan släktingar

related_human_id integer obligatoriskt
relationship_type string obligatoriskt

SDK och bibliotek

Färdiga bibliotek för populära programmeringsspråk

JavaScript/Node.js

Officiellt bibliotek för JavaScript och Node.js. Stöder webbläsare och servermiljöer.

Installera

Python

Python-bibliotek med stöd för asynkrona förfrågningar. Enkel integration med Django och Flask.

Installera

PHP

PHP-bibliotek med Composer-stöd. Kompatibelt med Laravel och Symfony.

Installera

Hastighetsgränser

Gränser för stabil API-prestanda

Förfrågningsgränser

Kontotyp Förfrågningar per minut Förfrågningar per dag
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Vanliga frågor

Redo att börja integrera?

Skaffa en API-nyckel och börja integrera Family-Tree.Online i dina applikationer

Skapa konto Kontakta oss