API công khai - TaiNanGiaoThong.com

Authentication

Liên hệ admin để được cấp API key. Mỗi key có quota mặc định 1000 request/ngày.

curl -H "X-Api-Key: YOUR_KEY" \
  "https://tainangiaothong.com/api/v1/news?province=ha-noi&from=2026-01-01&limit=20"

GET /api/v1/news

Lấy danh sách tin TNGT có filter.

Query parameters

Tham số	Kiểu	Mô tả
province	string	slug tỉnh, ví dụ `ha-noi`
from / to	date	khoảng ngày `YYYY-MM-DD`
severity	0..3	1=hư hỏng, 2=bị thương, 3=tử vong
q	string	tìm trong tiêu đề
limit / offset	int	phân trang (max 200)

Response

{
  "count": 20, "limit": 20, "offset": 0,
  "data": [
    {
      "id": 12345,
      "title": "...",
      "description": "...",
      "link": "https://...",
      "image": "https://...",
      "date": "2026-05-03 14:22:00",
      "severity": 3,
      "vehicle_type": "xetai",
      "death_count": 2,
      "injury_count": 5,
      "province": { "id": 1, "name": "Hà Nội", "slug": "ha-noi" }
    }
  ]
}

Rate limit

Header trả về X-RateLimit-Limit và X-RateLimit-Remaining. Khi vượt quota nhận HTTP 429.

RSS feed (không cần key)