API dokumentacija

Integrišite Family-Tree.Online u svoje aplikacije. Naš REST API omogućava kreiranje, čitanje i ažuriranje podataka porodičnog stabla.

Autentifikacija

Siguran API pristup

API ključevi

Za pristup API-ju potreban vam je API ključ iz postavki računa. Proslijedite ključ u Authorization zaglavlju.

Authorization: Bearer YOUR_API_KEY

Dobijanje API ključa

1. Prijavite se na svoj račun
2. Idite na "Postavke" → "API"
3. Kreirajte novi API ključ
4. Kopirajte ključ i sigurno ga pohranite

Porodična stabla

GET
/api/v1/trees

Dobijte listu svih porodičnih stabala korisnika

limit integer opcionalno
offset integer opcionalno
Primjer zahtjeva:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Primjer odgovora:
{ "data": [ { "id": 1, "name": "Ivanov Family", "description": "Glavno porodično stablo", "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

Kreirajte novo porodično stablo

name string obavezno
description string opcionalno
Primjer zahtjeva:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Petrov Family", "description": "Novo porodično stablo" }'

Članovi porodice

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

Dobijte listu svih članova porodice u stablu

tree_id integer obavezno
search string opcionalno
Primjer odgovora:
{ "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

Dodajte novog člana porodice

firstname string obavezno
secondname string obavezno
birthday date opcionalno
gender string opcionalno

Porodični odnosi

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

Kreirajte odnos između rođaka

related_human_id integer obavezno
relationship_type string obavezno

SDK-ovi i biblioteke

Gotove biblioteke za popularne programske jezike

JavaScript/Node.js

Službena biblioteka za JavaScript i Node.js. Podržava preglednike i serverska okruženja.

Instaliraj

Python

Python biblioteka sa podrškom za asinhroni zahtjevi. Jednostavna integracija sa Django i Flask.

Instaliraj

PHP

PHP biblioteka sa Composer podrškom. Kompatibilna sa Laravel i Symfony.

Instaliraj

Ograničenja brzine

Ograničenja za stabilne performanse API-ja

Ograničenja zahtjeva

Tip računa Zahtjeva po minuti Zahtjeva po danu
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Često postavljana pitanja

Spremni za integraciju?

Dobijte API ključ i počnite integrirati Family-Tree.Online u svoje aplikacije

Kreirajte račun Kontaktirajte nas