Bắt đầu nhanh với API BESfarm

API BESfarm cung cấp dữ liệu thị trường thủy sản Việt Nam mà BESfarm tổng hợp hằng ngày: giá tôm, giá cá, báo cáo tôm giống xuất bán và giá cổ phiếu ngành thủy sản. API chỉ đọc, không truy cập dữ liệu khách hàng, đơn hàng hay công nợ.

Dữ liệu được cập nhật 3 lần mỗi ngày lúc 6h, 12h và 18h giờ Việt Nam. Giá là giá tham khảo, có thể chênh theo vùng và thương lái.

1. Lấy khoá API

Nhắn Zalo 0339 190 079 kèm tên đơn vị và mục đích sử dụng. Khoá có dạng bes_live_… và chỉ hiện một lần. Xem chi tiết ở trang Khoá API.

2. Gọi thử

curl https://crm.besfarm.net/api/v1/market/shrimp \
  -H "Authorization: Bearer bes_live_KHOA_CUA_BAN"

Kết quả mẫu:

{
  "source": "tepbac.com, BESfarm tổng hợp",
  "items": [
    { "species_name": "Tôm thẻ (50 con/kg) tại ao", "category": "Tôm thẻ",
      "price": 125000, "unit": "đ/kg", "change_pct": 3.7, "price_date": "2026-10-12" }
  ]
}

3. Các điểm cuối

Phương thức, đường dẫn	Dữ liệu
`GET /api/v1/market/shrimp`	Giá tôm thẻ, tôm sú, tôm khác, giá giống theo cỡ
`GET /api/v1/market/fish`	Giá cá tra và cá nuôi khác
`GET /api/v1/market/stocks`	Cổ phiếu thủy sản Việt Nam và ngành tôm quốc tế
`GET /api/v1/market/seed-weekly`	Báo cáo tôm giống xuất bán trong tuần, theo tỉnh và loại giống
`GET/POST/DELETE /api/v1/webhooks`	Quản lý webhook, xem trang Webhook
`POST /mcp`	Máy chủ MCP cho trợ lý AI, xem trang MCP

4. Giới hạn và mã lỗi

60 yêu cầu mỗi phút cho mỗi khoá. Vượt thì nhận 429 rate_limited.
401 invalid_api_key: thiếu khoá, sai khoá hoặc khoá đã bị thu hồi.
Mỗi phản hồi có header X-BESfarm-Api-Version.

5. Ghi nguồn

Khi hiển thị lại dữ liệu, ghi nguồn theo trường source trong phản hồi và "BESfarm tổng hợp".