# Tài liệu API
API DDB được tạo thành từ một số dịch vụ microser khác nhau. Dưới đây bạn có thể thấy các dịch vụ khác nhau mà bạn có thể tương tác, cùng với cách xác thực và truy cập.
# Microservice
API của chúng tôi được phân tách thành *6 microservice *.
| Microservice | Mục đích |
|---|---|
| Dịch vụ bối cảnh môi trường | Dịch vụ bối cảnh môi trường lưu trữ dữ liệu các dự án hiện tại đang được sử dụng trong DDB. |
| Dịch vụ tham số | Một dịch vụ cung cấp thông tin về tài sản và thông số trong các dự án. |
| Dịch vụ siêu dữ liệu tham số | Một dịch vụ cung cấp siêu dữ liệu về tài sản và tham số trong các dự án. |
| Dịch vụ dữ liệu tham khảo | Thông tin dữ liệu nguồn được sử dụng để xác định các tham chiếu đến các nguồn bên trong và bên ngoài. |
| Dịch vụ QA | Máy chủ dữ liệu dịch vụ QA. |
| Dịch vụ bình luận | Dịch vụ bình luận nhằm mục đích lưu trữ các nhận xét có chủ đề liên quan đến nhiều hệ thống, tài sản và tham số khác nhau. |
Mỗi microservice có một ví dụ độc lập cho mỗi trong ba môi trường.
Để biết tóm tắt về mục đích của từng môi trường, hãy xem đây .
Bảng sau đây bao gồm các liên kết đến mỗi microservice, cho mỗi môi trường.
| Microservice | *Phát triển | Hộp cát | Sản xuất |
|---|---|---|---|
| Dịch vụ bối cảnh môi trường | Môi trường_context_dịch vụ (opens new window) | Môi trường_context_dịch vụ (opens new window) | Môi trường_context_dịch vụ (opens new window) |
| Dịch vụ tham số | tham số_service (opens new window) | tham số_service (opens new window) | tham số_service (opens new window) |
| Dịch vụ siêu dữ liệu tham số | parameter_metadata_dịch vụ (opens new window) | parameter_metadata_dịch vụ (opens new window) | parameter_metadata_dịch vụ (opens new window) |
| Dịch vụ dữ liệu tham khảo | tham chiếu_data_service (opens new window) | tham chiếu_data_service (opens new window) | tham chiếu_data_service (opens new window) |
| Dịch vụ QA | QA_Service (opens new window) | QA_Service (opens new window) | QA_Service (opens new window) |
| Dịch vụ bình luận | bình luận_service (opens new window) | bình luận_service (opens new window) | bình luận_service (opens new window) |
*Chỉ nhóm phát triển DDB nên sử dụng môi trường phát triển
Tất cả các dịch vụ khác nhau sử dụng cùng một URL cơ sở (ví dụ:https://ddb.arup.com (opens new window)) và được định tuyến theo URL của họ.
Mỗi microservice được xác định trong việc sử dụng API 3.0 mở (vênh vang). Nếu bạn không chắc chắn về các điểm cuối API liên quan đến quy trình của bạn, hãy liên hệ với nhóm trên tàu để được hỗ trợ nhiều hơn.
# Dòng chảy API
Sơ đồ dưới đây đang tóm tắt các bước cần thực hiện khi cố gắng lấy và đăng các tham số lên DDB.
Sơ đồ các cuộc gọi API cần thiết
