Τεκμηρίωση 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 στις εφαρμογές σας

Δημιουργία λογαριασμού Επικοινωνήστε μαζί μας