API փաստաթղթեր

Ինտեգրեք Family-Tree.Online-ը ձեր հավելվածներում։ REST API-ն թույլ է տալիս ստեղծել, կարդալ և թարմացնել ծագումնաբանական ծառի տվյալները։

Նույնականացում

Անվտանգ մուտք API

API բանալիներ

API մուտքի համար հաշվի կարգավորումներից API բանալի է պետք։ Բանալին ուղարկեք Authorization վերնագրում։

Authorization: Bearer YOUR_API_KEY

API բանալի ստանալը

1. Մտեք ձեր հաշիվ
2. Անցեք «Կարգավորումներ» → «API»
3. Ստեղծեք նոր API բանալի
4. Պատճենեք բանալին և պահեք անվտանգ

Ծագումնաբանական ծառեր

GET
/api/v1/trees

Ստանալ օգտատիրոջ բոլոր ծագումնաբանական ծառերի ցանկը

limit integer ընտրովի
offset integer ընտրովի
Հարցման օրինակ.
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Պատասխանի օրինակ.
{ "data": [ { "id": 1, "name": "Ivanov ընտանիք", "description": "Հիմնական ծագումնաբանական ծառ", "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

Ստեղծել նոր ծագումնաբանական ծառ

name string պարտադիր
description string ընտրովի
Հարցման օրինակ.
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Petrov ընտանիք", "description": "Նոր ծագումնաբանական ծառ" }'

Ընտանիքի անդամներ

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

Ստանալ ծառի բոլոր ընտանիքի անդամների ցանկը

tree_id integer պարտադիր
search string ընտրովի
Պատասխանի օրինակ.
{ "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

Ավելացնել նոր ընտանիքի անդամ

firstname string պարտադիր
secondname string պարտադիր
birthday date ընտրովի
gender string ընտրովի

Ընտանեկան կապեր

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

Ստեղծել կապ ազգականների միջև

related_human_id integer պարտադիր
relationship_type string պարտադիր

SDK և գրադարաններ

Պատրաստի գրադարաններ հայտնի ծրագրավորման լեզուների համար

JavaScript/Node.js

Պաշտոնական գրադարան JavaScript և Node.js-ի համար։ Աջակցում է դիտարկիչներ և սերվերային միջավայրեր։

Տեղադրել

Python

Python գրադարան ասինխրոն հարցումների աջակցությամբ։ Հեշտ ինտեգրում Django և Flask-ի հետ։

Տեղադրել

PHP

PHP գրադարան Composer աջակցությամբ։ Համատեղելի է Laravel և Symfony-ի հետ։

Տեղադրել

Հարցումների սահմանափակումներ

Սահմանափակումներ API-ի կայուն աշխատանքի համար

Հարցումների սահմանափակումներ

Հաշվի տեսակ Հարցումներ րոպեում Հարցումներ օրվա մեջ
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Հաճախակի հարցեր

Պատրա՞ստ եք սկսել ինտեգրումը։

Ստացեք API բանալի և սկսեք ինտեգրել Family-Tree.Online-ը ձեր հավելվածներում

Ստեղծել հաշիվ Կապ մեզ հետ