เอกสาร 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": "ครอบครัวอิวาโนฟ", "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": "ครอบครัวเปตรอฟ", "description": "แผนผังครอบครัวใหม่" }'

สมาชิกครอบครัว

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

ดึงรายการสมาชิกครอบครัวทั้งหมดในแผนผัง

tree_id integer จำเป็น
search string ไม่บังคับ
ตัวอย่างการตอบกลับ:
{ "data": [ { "id": 1, "firstname": "อีวาน", "secondname": "อิวาโนฟ", "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 ทำงานเสถียร

ขีดจำกัดคำขอ

ประเภทบัญชี คำขอต่อนาที คำขอต่อวัน
พื้นฐาน 60 1,000
Premium 300 10,000
ครอบครัว 1,000 50,000

คำถามที่พบบ่อย

พร้อมเริ่มเชื่อมต่อแล้วหรือยัง?

รับคีย์ API แล้วเริ่มเชื่อม Family-Tree.Online เข้ากับแอปพลิเคชันของคุณ

สร้างบัญชี ติดต่อเรา