API-dokumentation

Integrer Family-Tree.Online i dine applikationer. Vores REST API lader dig oprette, læse og opdatere slægtstræsdata.

Autentificering

Sikker API-adgang

API-nøgler

For at få adgang til API'et skal du bruge en API-nøgle fra dine kontoindstillinger. Send nøglen i Authorization-headeren.

Authorization: Bearer YOUR_API_KEY

Sådan får du en API-nøgle

1. Log ind på din konto
2. Gå til „Indstillinger“ → „API“
3. Opret en ny API-nøgle
4. Kopiér nøglen og opbevar den sikkert

Slægtstræer

GET
/api/v1/trees

Hent en liste over alle brugerens slægtstræer

limit integer valgfri
offset integer valgfri
Eksempel på anmodning:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Eksempel på svar:
{ "data": [ { "id": 1, "name": "Familien Ivanov", "description": "Hovedslægtstræ", "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

Opret et nyt slægtstræ

name string påkrævet
description string valgfri
Eksempel på anmodning:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Familien Petrov", "description": "Nyt slægtstræ" }'

Familiemedlemmer

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

Hent en liste over alle familiemedlemmer i et træ

tree_id integer påkrævet
search string valgfri
Eksempel 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

Tilføj et nyt familiemedlem

firstname string påkrævet
secondname string påkrævet
birthday date valgfri
gender string valgfri

Familierelationer

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

Opret en relation mellem slægtninge

related_human_id integer påkrævet
relationship_type string påkrævet

SDK'er og biblioteker

Færdige biblioteker til populære programmeringssprog

JavaScript/Node.js

Officielt bibliotek til JavaScript og Node.js. Understøtter browsere og servermiljøer.

Installer

Python

Python-bibliotek med understøttelse af asynkrone anmodninger. Nem integration med Django og Flask.

Installer

PHP

PHP-bibliotek med Composer-understøttelse. Kompatibelt med Laravel og Symfony.

Installer

Hastighedsbegrænsninger

Begrænsninger for stabil API-ydeevne

Anmodningsgrænser

Kontotype Anmodninger pr. minut Anmodninger pr. dag
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Ofte stillede spørgsmål

Klar til at begynde integrationen?

Få en API-nøgle og begynd at integrere Family-Tree.Online i dine applikationer

Opret konto Kontakt os