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-ის ინტეგრაცია თქვენს აპლიკაციებში