Dokumentasi API

Integrasikan Family-Tree.Online ke aplikasi Anda. REST API kami memungkinkan Anda membuat, membaca, dan memperbarui data pohon silsilah.

Autentikasi

Akses API yang aman

Kunci API

Untuk mengakses API, Anda memerlukan kunci API dari pengaturan akun. Kirimkan kunci di header Authorization.

Authorization: Bearer YOUR_API_KEY

Mendapatkan kunci API

1. Masuk ke akun Anda
2. Buka „Pengaturan“ → „API“
3. Buat kunci API baru
4. Salin kunci dan simpan dengan aman

Pohon silsilah

GET
/api/v1/trees

Dapatkan daftar semua pohon silsilah pengguna

limit integer opsional
offset integer opsional
Contoh permintaan:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Contoh respons:
{ "data": [ { "id": 1, "name": "Keluarga Ivanov", "description": "Pohon silsilah utama", "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

Buat pohon silsilah baru

name string wajib
description string opsional
Contoh permintaan:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Keluarga Petrov", "description": "Pohon silsilah baru" }'

Anggota keluarga

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

Dapatkan daftar semua anggota keluarga dalam sebuah pohon

tree_id integer wajib
search string opsional
Contoh respons:
{ "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

Tambahkan anggota keluarga baru

firstname string wajib
secondname string wajib
birthday date opsional
gender string opsional

Hubungan keluarga

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

Buat hubungan antar kerabat

related_human_id integer wajib
relationship_type string wajib

SDK dan pustaka

Pustaka siap pakai untuk bahasa pemrograman populer

JavaScript/Node.js

Pustaka resmi untuk JavaScript dan Node.js. Mendukung peramban dan lingkungan server.

Instal

Python

Pustaka Python dengan dukungan permintaan asinkron. Integrasi mudah dengan Django dan Flask.

Instal

PHP

Pustaka PHP dengan dukungan Composer. Kompatibel dengan Laravel dan Symfony.

Instal

Batas laju

Batas untuk kinerja API yang stabil

Batas permintaan

Jenis akun Permintaan per menit Permintaan per hari
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Pertanyaan yang sering diajukan

Siap mulai mengintegrasikan?

Dapatkan kunci API dan mulai integrasikan Family-Tree.Online ke aplikasi Anda

Buat akun Hubungi kami