# Tài liệu API Đèn Hạ Chí

Trang có đúng một API: gửi yêu cầu liên hệ. Không cần khoá hay đăng ký. Giới hạn 5 yêu cầu mỗi giờ cho mỗi địa chỉ IP. Đặc tả máy đọc: https://demo-02.thenexova.com/openapi.json · Danh mục: https://demo-02.thenexova.com/.well-known/api-catalog · Hướng dẫn cho agent: https://demo-02.thenexova.com/llms.txt

## Xác thực

Không có. Mọi yêu cầu đều ẩn danh; máy chủ chỉ ghi số điện thoại và tên để liên hệ lại (xem https://demo-02.thenexova.com/chinh-sach).

## POST /api/lead

Body JSON, `Content-Type: application/json`. Trường bắt buộc: `name`, `phone`, `consent` (phải là chuỗi `"1"`).

```bash
curl -X POST https://demo-02.thenexova.com/api/lead \
  -H "Content-Type: application/json" \
  -d '{"name":"Nguyễn Văn A","phone":"0900000000","need":"Chưa rõ","consent":"1"}'
```

Trả về `200 {"ok":true}`.

## Lỗi

Mọi lỗi đều là JSON:

- `405 {"ok":false,"error":"method_not_allowed"}`: chỉ nhận POST.
- `422 {"ok":false,"error":"..."}`: thiếu tên, số điện thoại hoặc chưa tích đồng ý.
- `429 {"ok":false,"error":"too_many"}`: quá 5 yêu cầu mỗi giờ, thử lại sau.
- `404 {"ok":false,"error":"not_found"}`: đường dẫn /api khác không tồn tại.

Trang mẫu của THE NEXOVA; Đèn Hạ Chí là doanh nghiệp hư cấu.