Trung tâm dành cho Nhà phát triểnCác hợp đồng tham chiếu

Tích hợp theo hợp đồng rõ ràng, không theo giả định.

Hướng dẫn tích hợp cấp doanh nghiệp cho lớp phân giải, DPP, tuyên bố, bằng chứng, vòng đời, bộ kết nối, sự kiện, môi trường thử nghiệm và kiểm thử tuân thủ của Trusted ThingID.

Hướng dẫn tích hợp Trung tâm API Bắt đầu nhanh

Chọn → Tích hợp → Kiểm thử → Phê duyệt → Vận hànhVòng đời

REST · Sự kiện · WebhookGiao diện

Môi trường thử nghiệm ≠ Vận hành thực tếMôi trường

CỔNG KIỂM SOÁT PHÁT HÀNH

Tích hợp là vòng đời có quản trị.

Bộ kết nối hoặc Client chỉ sẵn sàng phát hành khi đã xác định rõ phiên bản giao diện, môi trường, giới hạn và bằng chứng nghiệm thu.

01CHỌN

02TÍCH HỢP

03KIỂM THỬ

04PHÊ DUYỆT

05VẬN HÀNH

CHỦ ĐỀ TÍCH HỢP

Từ yêu cầu đầu tiên tới vận hành đã qua kiểm thử tuân thủ.

Các hợp đồng tham chiếu chủ động xác định rõ ràng ranh giới phạm vi và ngữ nghĩa xử lý lỗi

Bắt đầu nhanh

Tích hợp luồng phân giải và đọc DPP tham chiếu, sau đó bổ sung chính sách, bằng chứng và hành vi bộ kết nối theo phạm vi yêu cầu.

Xác thực & Phân quyền

Dùng mẫu OAuth/OIDC khi phù hợp, token giới hạn theo phạm vi, kèm ngữ cảnh mục đích và ủy quyền; tuyệt đối không đánh đồng xác thực, phân quyền và công bố dữ liệu theo trường.

Tài liệu API tham chiếu

Hợp đồng REST tham chiếu cho lớp phân giải, DPP, tuyên bố, bằng chứng, ủy quyền, vòng đời, tra cứu, tin cậy thiết bị và các thao tác của bộ kết nối.

API Phân giải

Phân giải định danh chính thức và bí danh, trả về ngữ cảnh nguồn/thẩm quyền cùng siêu dữ liệu về mức bảo đảm.

DPP API

Đọc và quản lý tài nguyên DPP đủ điều kiện theo chính sách, mà không biến API thành thẩm quyền cho mọi trường dữ liệu.

API Tuyên bố

Tạo, truy vấn, thay thế và tranh chấp các tuyên bố có bằng chứng, kèm ngữ cảnh chủ thể phát hành/nguồn/phiên bản.

Bằng chứng API

Ghi nhận tham chiếu bằng chứng, nguồn gốc dữ liệu, dấu thời gian tin cậy, tính toàn vẹn và siêu dữ liệu lưu giữ.

Ủy quyền API

Biểu diễn ủy quyền/Gửi hồ sơ ủy quyền theo vòng đời độc lập với Định danh và quyền sở hữu.

Vòng đời API

Áp dụng chuyển trạng thái vật liệu có quy trách nhiệm, gắn phiên bản chính sách, kèm điều kiện tiên quyết và bằng chứng.

Tra cứu API

Tra cứu trên các mô hình đọc dẫn xuất mà không coi chỉ mục tra cứu là bản ghi có thẩm quyền.

Bộ kết nối Hợp đồng

Ngữ cảnh thẩm quyền có gắn phiên bản, ngữ nghĩa phân phối, cơ chế thử lại, đối soát, chế độ suy giảm và kiểm soát khi rời dịch vụ.

Sự kiện / AsyncAPI

Sự kiện bất đồng bộ cho vòng đời, tuyên bố, bằng chứng và bộ kết nối, kèm khóa tương quan và ngữ nghĩa an toàn khi phát lại.

Webhook

Mẫu lệnh gọi lại có ký số hoặc xác thực, kèm cơ chế chống trùng lặp (idempotency) và bằng chứng phân phối.

Lược đồ dữ liệu

Lược đồ JSON chuẩn tắc làm nền cho tuyên bố, bằng chứng, sự kiện vòng đời và trạng thái bộ kết nối.

SDK & Mẫu tích hợp

Ví dụ hướng tới chạy được ngay cùng các mẫu tích hợp; gói cung cấp hợp đồng tham chiếu, không tuyên bố đây là SDK vận hành thực tế đã được chứng nhận.

Môi trường thử nghiệm

Mô hình môi trường thử nghiệm theo dự án, dùng dữ liệu mô phỏng, tách biệt môi trường và không chứa thông tin bí mật của hệ thống vận hành thực tế.

Phòng kiểm thử tuân thủ

Kiểm thử đúng tổ hợp hồ sơ/phiên bản/môi trường và lưu giữ bằng chứng để phê duyệt phát hành.

Các hợp đồng tham chiếu

Các tệp đọc được bằng máy được đóng gói kèm website.

Dùng làm bản nền thiết kế và gắn phiên bản cho từng triển khai thực tế.

Hãy đọc Hướng dẫn Tích hợp và Tài liệu API dạng HTML trước. Các tệp bên dưới dành cho công cụ, sinh mã tự động và khóa cứng phiên bản hợp đồng.

OpenAPI 3.1

HTML tham chiếu

Các thao tác REST, ngữ nghĩa nghiệp vụ và ví dụ

Xem trực tuyến

AsyncAPI

HƯỚNG DẪN HTML

Sự kiện, phân phối, xác minh và thử lại

Xem trực tuyến

Lược đồ dữ liệu JSON

HƯỚNG DẪN HTML

Mục đích của lược đồ, cách quản lý phiên bản và việc kiểm tra

Xem trực tuyến

Postman

HƯỚNG DẪN TÍCH HỢP

Chỉ dùng bộ sưu tập này sau khi đã hiểu về định danh, ủy quyền và vòng đời

Xem trực tuyến

Đặc tả đọc được bằng máy

Tải OpenAPI YAML Tải AsyncAPI YAML Tải JSON Lược đồ dữ liệu Tải Postman JSON

Nhà phát triển Sản phẩm UI

Cổng tích hợp nhìn như thế nào trong thực tế

Thông tin xác thực · Trình khám phá API · Webhook · Môi trường thử nghiệm · Kiểm thử tuân thủ

TTID-S08-M01-L02-001

Danh sách ứng dụng / client

Danh sách ứng dụng / client

TTID-S08-M02-L01-001

Danh mục API

Danh mục API

TTID-S08-M05-L01-001

Danh sách tác vụ môi trường thử nghiệm

Danh sách tác vụ môi trường thử nghiệm

TTID-S08-M06-L02-002

Kết quả đánh giá bằng chứng kiểm thử tuân thủ

Kết quả đánh giá bằng chứng kiểm thử tuân thủ

HỆ THỐNG SẢN PHẨM DOANH NGHIỆP

Từ tìm hiểu đến thí điểm và đưa vào vận hành cổng kiểm soát.

Hồ sơ sản phẩm

Sản phẩm đạt chuẩn phục vụ ra quyết định, mức độ hoàn thiện và ranh giới phạm vi

Mở →

Hướng dẫn sản phẩm

Phạm vi vận hành, vai trò, lỗi và phiên bản.

Mở →

Phòng thử nghiệm liên thông

Hồ sơ kỹ thuật theo phiên bản và bằng chứng kiểm thử.

Mở →

Trung tâm kiểm thử tuân thủ

Kiểm thử hợp lệ / không hợp lệ và bằng chứng kỳ vọng.

Mở →

Hồ sơ mức sẵn sàng

Các thành phần thực tế đã sẵn sàng, phụ thuộc bên ngoài hoặc đặc thù theo từng triển khai.

Mở →

HỘI THẢO KIẾN TRÚC

Xác định ranh giới tích hợp trước khi viết mã cho môi trường vận hành thực tế.

Căn chỉnh phạm vi nhóm sản phẩm, ranh giới thẩm quyền, hành trình cổng nghiệp vụ, hợp đồng tích hợp và bằng chứng trước khi tuyên bố sẵn sàng vận hành.

Đăng ký hội thảo Xem kiến trúc