Documentación de la API

Integre Family-Tree.Online en sus aplicaciones. Nuestra API REST le permite crear, leer y actualizar datos del árbol genealógico.

Autenticación

Acceso seguro a la API

Claves API

Para acceder a la API, necesita una clave API en la configuración de su cuenta. Pase la clave en la cabecera Authorization.

Authorization: Bearer YOUR_API_KEY

Obtener una clave API

1. Inicie sesión en su cuenta
2. Vaya a «Ajustes» → «API»
3. Cree una nueva clave API
4. Copie la clave y guárdela de forma segura

Árboles familiares

GET
/api/v1/trees

Obtener la lista de todos los árboles familiares del usuario

limit integer opcional
offset integer opcional
Ejemplo de solicitud:
curl -X GET "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY"
Ejemplo de respuesta:
{ "data": [ { "id": 1, "name": "Familia Ivanov", "description": "Árbol familiar 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

Crear un nuevo árbol familiar

name string obligatorio
description string opcional
Ejemplo de solicitud:
curl -X POST "https://api.familytreeonline.com/api/v1/trees" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "name": "Familia Petrov", "description": "Nuevo árbol familiar" }'

Miembros de la familia

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

Obtener la lista de todos los miembros de la familia de un árbol

tree_id integer obligatorio
search string opcional
Ejemplo de respuesta:
{ "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

Añadir un nuevo miembro de la familia

firstname string obligatorio
secondname string obligatorio
birthday date opcional
gender string opcional

Relaciones familiares

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

Crear una relación entre parientes

related_human_id integer obligatorio
relationship_type string obligatorio

SDK y bibliotecas

Bibliotecas listas para los lenguajes de programación más usados

JavaScript/Node.js

Biblioteca oficial para JavaScript y Node.js. Compatible con navegadores y entornos de servidor.

Instalar

Python

Biblioteca Python con soporte de peticiones asíncronas. Integración sencilla con Django y Flask.

Instalar

PHP

Biblioteca PHP con soporte de Composer. Compatible con Laravel y Symfony.

Instalar

Límites de frecuencia

Límites para garantizar un rendimiento estable de la API

Límites de peticiones

Tipo de cuenta Peticiones por minuto Peticiones por día
Basic 60 1,000
Premium 300 10,000
Family 1,000 50,000

Preguntas frecuentes

¿Listo para empezar la integración?

Obtenga una clave API y empiece a integrar Family-Tree.Online en sus aplicaciones