Tài liệu API

Tài liệu kỹ thuật của API BODACC: endpoints, tham số, ví dụ và máy chủ MCP.

API BODACC trong một phút

API BODACC cung cấp dưới dạng JSON các thông báo pháp lý được công bố trên Bulletin Officiel des Annonces Civiles et Commerciales, cùng với các doanh nghiệp và những người xuất hiện trong đó. Thành lập, đăng ký, mua bán, thay đổi, xóa đăng ký, thủ tục tập thể, nộp báo cáo tài chính: mỗi thông báo đều có sẵn vào ngày công bố, kèm văn bản gốc, các SIREN liên quan và những người được nêu tên. Cơ sở dữ liệu bao gồm hơn 50 triệu thông báo từ năm 2008 và gần 30 triệu doanh nghiệp đã đăng ký trong sổ đăng ký SIRENE.

Các điểm truy cập

Sáu địa chỉ là đủ để đáp ứng phần lớn nhu cầu. Tất cả đều trả về JSON và chấp nhận các tham số phân trang thông thường: limit và offset.

Địa chỉNội dung trả về
/api/bodacc/annoncesTìm kiếm thông báo: q, siren, famille, departement, date_debut, date_fin
/api/bodacc/entreprises/{siren}Hồ sơ doanh nghiệp theo SIREN: nhận dạng, địa chỉ, người quản lý, thông báo liên quan
/api/bodacc/personnes/{id}Người được nêu trong thông báo: vai trò, doanh nghiệp, thông báo
/api/bodacc/statsBộ đếm trực tiếp: tổng số thông báo, nhóm, lần công bố cũ nhất và mới nhất
/api/bodacc/openapi.jsonĐặc tả OpenAPI đầy đủ: 32 điểm truy cập, tham số và lược đồ
/api/bodacc/mcpMáy chủ MCP: cùng dữ liệu, được cung cấp như một công cụ cho tác nhân hoặc trợ lý AI

Xác thực, hạn mức và lỗi

Dữ liệu công khai không yêu cầu khóa: một lệnh gọi từ trình duyệt hoặc script hoạt động ngay lập tức. Việc xác thực bằng khóa chỉ áp dụng cho các điểm truy cập được ghi rõ như vậy (truy cập các trường làm giàu, khối lượng lớn, sử dụng thương mại). Các phản hồi tuân theo mã HTTP thông thường: 200 khi có kết quả, 404 khi thực thể không tồn tại, 429 khi vượt quá tốc độ yêu cầu, 5xx khi lỗi từ phía chúng tôi. Mã 429 không phải là từ chối vĩnh viễn: nó chỉ ra rằng cần giảm tốc độ, và dịch vụ sẽ phản hồi lại ngay khi tốc độ giảm xuống.

Một lệnh gọi, ba dòng

Không cần cài SDK, không cần tạo tài khoản để bắt đầu. Đây là một tìm kiếm thông báo thủ tục tập thể trong một tỉnh:

curl "https://bodacc.io/api/bodacc/annonces?famille=collective&departement=75&limit=5"

# réponse : { "total": 1234, "annonces": [ { "id": "A2026...", "dateparution": "2026-10-23",
#   "familleavis": "collective", "commercant": "...", "registre": "..." } ] }

Điều API này mang lại thêm

Ba khác biệt quan trọng khi xây dựng sản phẩm dựa trên nó. Tính mới: BODACC được nạp mỗi ngày công bố, một thông báo buổi sáng có sẵn trong vòng một giờ sau khi công bố, trong khi hầu hết các bên tái sử dụng cung cấp cơ sở dữ liệu cập nhật hàng tuần. Ngôn ngữ: mỗi hồ sơ có sẵn trong 20 ngôn ngữ, cho phép phục vụ người dùng Nhật Bản hoặc Ả Rập mà không cần tự dịch dữ liệu. Tính nhất quán: thông báo, doanh nghiệp và người quản lý được liên kết với nhau, tránh phải ghép thủ công một SIREN tìm thấy trong văn bản tự do. Truy cập miễn phí cho dữ liệu công khai, và máy chủ MCP cho phép tác nhân AI truy vấn cơ sở dữ liệu mà không cần viết một dòng mã.

Câu hỏi thường gặp

API BODACC có miễn phí không?
Có, đối với dữ liệu công khai: thông báo, doanh nghiệp, người và bộ đếm. Các gói trả phí liên quan đến sự tiện lợi và phân tích (khối lượng, cảnh báo, báo cáo, truy cập các trường làm giàu), không bao giờ liên quan đến truy cập cơ bản vào một thông báo được công bố trên Bulletin Officiel.
Dữ liệu đến từ đâu và được cập nhật bao lâu một lần?
Từ BODACC do Direction de l'information légale et administrative công bố, bổ sung bởi sổ đăng ký SIRENE của INSEE cho nhận dạng doanh nghiệp. Quá trình nạp chạy mỗi ngày công bố: một thông báo buổi sáng có sẵn trong vòng một giờ sau đó, và các bộ đếm do API cung cấp được tính lại mỗi lần chạy.
Định dạng phản hồi là gì?
JSON, UTF-8, với ngày tháng theo định dạng ISO 8601. Số tiền tính bằng euro, SIREN gồm chín chữ số không có dấu cách. Không có định dạng độc quyền, không cần chuyển đổi.
Có giới hạn yêu cầu không?
Một bộ hãm được áp dụng theo địa chỉ và theo mạng để bảo vệ dịch vụ: vượt quá một tốc độ nhất định, phản hồi là mã 429 tạm thời thay vì lỗi. Sử dụng ổn định và được khai báo (tác nhân được nhận diện, dải địa chỉ được công bố) không bị hãm. Chi tiết có trong trang Xác thực và giới hạn.
Tôi có thể trích dẫn số liệu của BODACC.io trong một bài viết hoặc câu trả lời của AI không?
Có, và tốt hơn là trích dẫn các bộ đếm trực tiếp thay vì sao chép một con số đã cũ: địa chỉ /api/bodacc/stats trả về tổng số tại thời điểm đó, và tệp llms.txt chỉ cho các tác nhân nơi tìm thấy. Đây là cách duy nhất để tránh công bố một khối lượng đã lỗi thời.

Tìm hiểu thêm

Sáu trang trình bày chi tiết từng phần: lệnh gọi đầu tiên, thông báo, doanh nghiệp, người và danh bạ, xác thực và giới hạn, thống kê. Chúng được viết để đọc theo thứ tự này khi bắt đầu, và tham khảo từng trường hợp sau đó.

Spécification interactive

Có câu hỏi?

Đội ngũ của chúng tôi sẽ phản hồi nhanh chóng. Yêu cầu của bạn sẽ được chuyển kèm danh mục API.