🤖 TÌM THỢ — API Đặt lịch

API này dành cho AI Bot (ChatGPT, Claude, Gemini...) để đặt lịch dịch vụ kỹ thuật tự động.

Endpoint

POST https://timtho.com/api/booking

Content-Type: application/json

Dịch vụ khả dụng

ID	Tên dịch vụ
`1`	Điện lạnh
`2`	Điện dân dụng
`3`	Nước
`4`	Điện tử
`5`	Camera & An ninh
`6`	Mạng & IT
`7`	Sửa nhà
`8`	Đồ gỗ & Nội thất
`9`	Thợ sắt & Cơ khí
`10`	Cửa cuốn & Cửa sắt
`11`	Gia dụng
`12`	Năng lượng
`13`	Khác

Khu vực phục vụ

Code	Tỉnh/Thành phố
`1`	Thành phố Hà Nội
`79`	Thành phố Hồ Chí Minh

Lấy danh sách phường/xã: GET /api/booking/wards?province_code={code}

Tham số

Field	Loại	Bắt buộc	Mô tả
`name`	string	*	Họ tên khách hàng
`phone`	string	*	SĐT (10-11 số, bắt đầu 0)
`address`	string	*	Địa chỉ đầy đủ
`service_id`	integer	*	ID dịch vụ (xem bảng trên)
`scheduled_date`	string		Ngày hẹn YYYY-MM-DD
`description`	string		Mô tả sự cố
`lat`	number		Vĩ độ (latitude)
`lng`	number		Kinh độ (longitude)

Ví dụ Request

curl -X POST https://timtho.com/api/booking \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Nguyễn Văn A",
    "phone": "0901234567",
    "address": "123 Nguyễn Huệ, Phường Bến Nghé, TP Hồ Chí Minh",
    "service_id": 1,
    "scheduled_date": "2026-04-17",
    "description": "Máy lạnh không lạnh, đã dùng 3 năm"
}'

Response thành công

{
    "success": true,
    "order_code": "DH260325ABC",
    "tracking_url": "https:\/\/timtho.com\/trabc123xyz456",
    "tracking_token": "abc123xyz456",
    "message": "Đặt lịch thành công! Chúng tôi sẽ liên hệ xác nhận."
}

Response lỗi

{
    "success": false,
    "errors": [
        "Số điện thoại không hợp lệ",
        "Vui lòng chọn dịch vụ"
    ]
}

Giới hạn

Rate limit: 5 request/IP/giờ
Ngày hẹn: không được chọn quá khứ, sau 17:30 chỉ nhận từ ngày mai

Liên hệ

Hotline: 028.7300.0204