Bề mặt API cho nhà phát triển

Hướng dẫn tích hợp trước khi mở rộng các điểm cuối

Bề mặt nhà phát triển chuẩn bị cho đội ngũ cách tiếp cận xác thực, tích hợp có tenant, xử lý sự kiện, hướng dẫn nộp có kiểm soát và quy trình kế toán có quản trị theo từng quốc gia trước khi mở rộng API công khai.

Mở tài liệu Mở help Trung tâm luật Việt Nam

Định hướng public

Những gì bề mặt nhà phát triển đang chuẩn bị

Xác thực và tenant

Identity, tenant scoping, role-aware access và session behavior an toàn cho chứng cứ nghiệp vụ.

Document và intake flow

File intake, validation, queueing, rà soát state và lineage của record cho quy trình kế toán.

Events và webhooks

Thay đổi trạng thái, rà soát outcome, hướng dẫn nộp có kiểm soát progress, gói xuất dữ liệu handoff và event delivery có audit là một phần của roadmap.

Tích hợp theo country

Mọi bề mặt tích hợp đều phải theo phạm vi của gói quốc gia đã duyệt, đúng trung tâm luật và đúng sự thật đã đồng bộ giữa docs/help/API.

Tư thế phát hành

Bề mặt API mở theo từng tầng có kiểm soát

Công bố terminology, lifecycle và integration guidance trước.
Công bố giả định về xác thực, chứng cứ nghiệp vụ và tenant trước khi mở rộng các điểm cuối.
Giữ tài liệu nhà phát triển bám cùng sự thật sản phẩm như docs và help.
Mở tuyến tích hợp cho đối tác và pilot chỉ sau khi phát hành có quản trị được duyệt.
Giữ sự thật về tuyến quốc gia và bộ chọn thật chặt để không trang API nào làm người đọc hiểu rằng một quốc gia đã live trước khi đủ gói quốc gia, trung tâm luật, docs/help/API đồng bộ, phê duyệt pháp lý và gate điều hướng.
Giữ changelog, versioning và ranh giới hỗ trợ rõ khi bề mặt mở rộng.

Rào chắn cho nhà phát triển

Những gì bị khóa trên bề mặt API công khai

Không đưa secret lên client

Secret, token sống dài và credential có đặc quyền không được xuất hiện trong client code hoặc snippet public.

Contract phải có version

Lược đồ dùng chung và hợp đồng tích hợp cần có tư thế thay đổi được mô tả trước khi mở rộng cho đối tác sử dụng.

Phạm vi theo quốc gia

Mọi phát biểu tích hợp phải khớp với gói quốc gia, chế độ nộp hồ sơ và thực tế hỗ trợ đã duyệt cho quốc gia đó. Với Việt Nam hiện tại, đường đi an toàn công khai dừng ở hướng dẫn nộp có kiểm soát và gói xuất dữ liệu.

Không mở host quốc gia khi chưa qua gate

vn.aiaccountingloop.com là host quốc gia đầu tiên đã qua quản trị. Không host quốc gia, mục dropdown hay lane điều hướng tự động nào khác được xuất hiện trên bề mặt API trước khi gate đầy đủ có hiệu lực.

Audit và chứng cứ nghiệp vụ đi trước

Event history quan sát được và quy trình an toàn cho chứng cứ nghiệp vụ đi trước các tính năng tiện lợi.

Giá API công khai và việc công bố các điểm cuối rộng vẫn còn riêng tư tính đến ngày 13/04/2026. Trang này khóa định hướng nhà phát triển có quản trị, không phải gói thương mại public.

Lane luật quốc gia đầu tiên đã được quản trị là Việt Nam tại /vi/countries/vn/, đi cùng host quốc gia đầu tiên là vn.aiaccountingloop.com.

Ảnh chụp đài kiểm soát

Định hướng nhà phát triển phải nằm trong trạng thái kiểm soát đang live của Team 1

Tư thế nộp hồ sơ công khai

guided submission only

Câu từ cho nhà phát triển phải nằm trong biên nộp hồ sơ công khai hiện hành.

Đường đi an toàn công khai

EXPORT_PACKAGE

Không trang API công khai nào được hàm ý con đường nộp hồ sơ mạnh hơn hiện tại.

Decision đang hiệu lực

Định hướng nhà phát triển chỉ bám các quyết định Team 1 hiện còn hiệu lực.

Snapshot Team 1 mới nhất: 2026-04-13 16:00:30 +0700.