--- title: "Trang chủ" url: "https://oapi-poc.hdbank.work/" image: "https://oapi-poc.hdbank.work/_og/d/c_Ocean.takumi,title_~VHJhbmcgY2jhu6c,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMwMDAwRjUifX19,s_MgXvh1Dqm6JjQJf9.png" --- API Exchange · Tập đoàn Sovico # Kết nối dữ liệu chuyển đổi số qua một cổng API duy nhất Cổng thử nghiệm Sovico TMO Open API: các đơn vị thành viên công bố và sử dụng API an toàn, có kiểm soát, quản trị tập trung bởi Văn phòng TMO. Dữ liệu 100% giả lập. [Xem danh mục API](https://oapi-poc.hdbank.work/apis)[Bắt đầu tích hợp](https://oapi-poc.hdbank.work/bat-dau) **49**API mẫu trong danh mục, dữ liệu giả lập **2**Môi trường: Sandbox, Production mô phỏng **4**Bậc hạn mức: Public đến Strategic cURLJavaScriptPython curl -X GET \\ https://apis-dev.hdbank.work/quotes/qt-1 \\ -H "apikey: $KEY" # phản hồi { "quote\_id": "qt-1", "premium": 1200000, "currency": "VND" } const res = await fetch( "https://apis-dev.hdbank.work/quotes/qt-1", { headers: { apikey: key } } ); const quote = await res.json(); console.log(quote.premium); // 1200000 import requests r = requests.get( "[https://apis-dev.hdbank.work/quotes/qt-1](https://apis-dev.hdbank.work/quotes/qt-1)", headers={"apikey": key}, ) print(r.json()"premium") # 1200000 ● 200 OK · sandbox, dữ liệu giả lập Danh mục API ## [Khám phá API sẵn sàng tích hợp](#khám-phá-api-sẵn-sàng-tích-hợp) ## Approval Workflow API 1.8 Khởi tạo và theo dõi luồng phê duyệt nhiều cấp với SLA và ủy quyền. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/approval-workflow-api/docs) ## Baggage 1.3 Mua thêm hành lý ký gửi theo gói cân nặng, trước chuyến bay hoặc sau khi đã xuất vé. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/baggage/docs) ## Bancassurance Offers 0.8 Gợi ý và khởi tạo hồ sơ sản phẩm bảo hiểm liên kết theo hồ sơ khách hàng. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/bancassurance-offers/docs) ## Bill Payments 1.7 Thanh toán hóa đơn điện, nước, viễn thông, thẻ tín dụng và khoản vay. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/bill-payments/docs) ## Booking 3.0 Giữ chỗ, nhập thông tin hành khách và tạo mã đặt chỗ (PNR) cho đại lý trực tuyến. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/booking/docs) ## Booking Management 1.8 Tra cứu, đổi chuyến, đổi tên, hủy và hoàn vé theo điều kiện hạng vé. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/booking-management/docs) ## Branches & ATMs 1.3 Vị trí chi nhánh, phòng giao dịch, ATM và đặt lịch hẹn tại quầy. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/branches-atms/docs) ## Budget & Cost API 2.1 Ngân sách phân bổ, chi phí thực tế và chỉ số CPI/SPI theo dự án. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/budget-cost-api/docs) ## Cards 1.6 Đăng ký phát hành thẻ ghi nợ, thẻ tín dụng và theo dõi trạng thái hồ sơ mở thẻ. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/cards/docs) ## Channel Preferences 1.0 Thiết lập kênh liên lạc ưu tiên và lịch sử truy cập gần đây của khách hàng. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/channel-preferences/docs) ## Customer Profile 1.5 Truy vấn thông tin định danh và nhân khẩu học của khách hàng khi có sự đồng ý. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/customer-profile/docs) ## Deposit Accounts 2.0 Danh sách và chi tiết tài khoản thanh toán, tiết kiệm có kỳ hạn, tài khoản đa tiền tệ. (API mẫu của cổng thử nghiệm, dữ liệu 100% giả lập.) [View API](https://oapi-poc.hdbank.work/apis/deposit-accounts/docs) Cách hoạt động ## [Từ đăng ký đến vận hành trong bốn bước](#từ-đăng-ký-đến-vận-hành-trong-bốn-bước) 01 ### [Đăng ký ứng dụng](#đăng-ký-ứng-dụng) Tạo tài khoản nhà phát triển bằng email, rồi tạo ứng dụng trên cổng. 02 ### [Yêu cầu quyền truy cập](#yêu-cầu-quyền-truy-cập) Chọn API cần dùng. INS-02 mở cho mọi nhà phát triển; IDN-01 và PAY-03 dành cho team được cấp quyền. 03 ### [Thử nghiệm trên Sandbox](#thử-nghiệm-trên-sandbox) Nhận khóa sandbox ngay, thử với dữ liệu giả lập qua tài liệu OpenAPI tương tác. 04 ### [Lên Production mô phỏng](#lên-production-mô-phỏng) Sau khi API owner duyệt, ứng dụng được cấp thông tin OAuth 2.0 để gọi môi trường production mô phỏng. ### [Đơn vị sử dụng API](#đơn-vị-sử-dụng-api) - Gọi API qua một điểm truy cập thống nhất với xác thực chuẩn - Tài liệu OpenAPI 3.0 và nút thử gọi trực tiếp trên cổng - Hạn mức theo bậc, kèm tiêu đề RateLimit trên mọi phản hồi [Bắt đầu tích hợp](https://oapi-poc.hdbank.work/bat-dau) ### [Đơn vị cung cấp API](#đơn-vị-cung-cấp-api) - Công bố API lên gateway tập trung, không tự vận hành hạ tầng - Kiểm soát người dùng, phạm vi truy cập và duyệt ứng dụng - Nhật ký sử dụng cho từng lượt gọi, không ghi nội dung request [Liên hệ TMO](https://oapi-poc.hdbank.work/ho-tro) Bảo mật và quản trị ## [Chia sẻ dữ liệu trong khuôn khổ kiểm soát](#chia-sẻ-dữ-liệu-trong-khuôn-khổ-kiểm-soát) Mọi API được công bố qua gateway tập trung, có xác thực và hạn mức cho từng ứng dụng. **OAuth 2.0 và mTLS**Xác thực ứng dụng bằng client credentials, mTLS cho API nhạy cảm. **Phân quyền theo phạm vi**Mỗi ứng dụng chỉ gọi đúng API và scope đã được phê duyệt. **Nhật ký sử dụng**Mỗi lượt gọi sinh một bản ghi usage-event để đối soát; không lưu nội dung request. **Hạn mức và giám sát**Rate limit theo ứng dụng; vượt ngưỡng trả 429 kèm Retry-After. ## [Sẵn sàng kết nối?](#sẵn-sàng-kết-nối) Đọc hướng dẫn tích hợp hoặc liên hệ Văn phòng TMO để được hỗ trợ đánh giá nhu cầu. [Liên hệ TMO](https://oapi-poc.hdbank.work/ho-tro)[Xem hướng dẫn](https://oapi-poc.hdbank.work/bat-dau)