Documentation API

Intégrez Family-Tree.Online à vos applications. Notre API REST vous permet de créer, lire et mettre à jour les données d'arbre généalogique.

Authentification

Accès API sécurisé

Clés API

Pour accéder à l'API, vous avez besoin d'une clé API dans les paramètres de votre compte. Passez la clé dans l'en-tête Authorization.

Authorization: Bearer YOUR_API_KEY

Obtenir une clé API

1. Connectez-vous à votre compte
2. Allez dans « Paramètres » → « API »
3. Créez une nouvelle clé API
4. Copiez la clé et conservez-la en lieu sûr

Arbres familiaux

GET
/api/v1/trees

Obtenir la liste de tous les arbres familiaux de l'utilisateur

limit integer facultatif
offset integer facultatif
Exemple de requête :
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Exemple de réponse :
{ "data": [ { "id": 1, "name": "Famille Ivanov", "description": "Arbre familial principal", "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

Créer un nouvel arbre familial

name string obligatoire
description string facultatif
Exemple de requête :
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Famille Petrov", "description": "Nouvel arbre familial" }'

Membres de la famille

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

Obtenir la liste de tous les membres de la famille d'un arbre

tree_id integer obligatoire
search string facultatif
Exemple de réponse :
{ "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

Ajouter un nouveau membre de la famille

firstname string obligatoire
secondname string obligatoire
birthday date facultatif
gender string facultatif

Liens de parenté

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

Créer un lien entre des proches

related_human_id integer obligatoire
relationship_type string obligatoire

SDK et bibliothèques

Bibliothèques prêtes à l'emploi pour les langages de programmation courants

JavaScript/Node.js

Bibliothèque officielle pour JavaScript et Node.js. Prend en charge les navigateurs et les environnements serveur.

Installer

Python

Bibliothèque Python avec prise en charge des requêtes asynchrones. Intégration facile avec Django et Flask.

Installer

PHP

Bibliothèque PHP avec prise en charge de Composer. Compatible avec Laravel et Symfony.

Installer

Limites de débit

Limites pour garantir des performances API stables

Limites de requêtes

Type de compte Requêtes par minute Requêtes par jour
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Questions fréquentes

Prêt à commencer l'intégration ?

Obtenez une clé API et commencez à intégrer Family-Tree.Online à vos applications

Créer un compte Nous contacter