Mobile-ID Sign · TÍCH HỢP & THỰC HÀNH

RSS: Đăng ký, ký hash và đối soát

Đọc cấu trúc được biên tập từ Specification. Các điểm chưa thống nhất được ghi tại operation; chưa cấu hình máy chủ thực thi.

Hành trình tích hợp Xem thao tác Viewer

TRONG TRANG NÀY

Mức bao phủ và điều kiện tích hợp

Tài liệu có dẫn nguồn; mức xác nhận đặc tả, thử nghiệm sandbox và nghiệm thu production là các bước độc lập. Việc đổi phiên bản website không thay thế xác nhận tích hợp.

Xem mức bao phủ của từng operation

Trạng thái theo operation
Operation	Mức tài liệu	Đặc tả	Sandbox
`POST /v1/create/credential`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /v1/get/credential/status`	Phản hồi chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /v1/sign/hash`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /v1/get/signing/status`	Phản hồi chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /v1/get/certificates`	Phản hồi chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`POST /v1/request/citizen/identity-sharing`	Trường chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử
`GET /v1/get/citizen/identity-sharing`	Phản hồi chọn lọc	Chưa có xác nhận triển khai	Chưa kiểm thử

Tải OpenAPI đúng phạm vi · Tải Postman đọc đặc tả

RSS, Postman và kênh sự kiện

Specification 1.11.260911 là nguồn hiện hành được cung cấp. Phân biệt REST đối tác, callback và Kafka nội bộ. Lưu x-billcode-id theo operation cùng mã yêu cầu phía gọi; không suy identity-sharing hoặc citizen ID check thành kiểm chứng chữ ký số.

Gateway API Gateway Viewer SIC Compact

Phạm vi và tài sản

Nguồn: RSS 1.11.260911. OpenAPI biên tập 7 operation với trường chọn lọc; danh mục giữ 18 chức năng REST nguồn. Không phải hợp đồng API vận hành thực tế được nghiệm thu.

OpenAPI JSON OpenAPI YAML Postman Environment

Thao tác API và cấu trúc dữ liệu

POST/v1/create/credential

Đăng ký credential

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

OperationId: RssCreateCredential · RSS 1.11.260911 · Trang PDF: 15, 16, 17, 18, 19

Trích từ nguồn; môi trường triển khai chưa xác nhận. Ví dụ đầu vào dùng để đọc và đối chiếu, chưa cấu hình gọi dịch vụ thật.

Điều kiện và xác thực

Xác nhận provider, gói, partner_code và originator_id; chuẩn bị dữ liệu đăng ký đúng phạm vi đồng ý. Chưa cần credential đã phát hành. Token Bearer giữ phía máy chủ; không đưa token/SAD vào frontend hoặc log công khai.

Header theo operation
Header	Bắt buộc	Ý nghĩa
`x-language`	Không	Ngôn ngữ phản hồi.
`x-rp-id`	Không	Tham chiếu do RP sinh, khác với x-billcode-id do dịch vụ sinh.

Yêu cầu · application/json

Cấu trúc yêu cầu
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`provider`	string	Bắt buộc	Mã nhà cung cấp trong RSS; xác nhận cấu hình triển khai.
`service_package_code`	string	Bắt buộc	Mã gói của nhà cung cấp.
`partner_code`	string	Bắt buộc	Mã đối tác gửi yêu cầu.
`originator_id`	string	Bắt buộc	Mã định danh ứng dụng gửi yêu cầu.
`platform`	string	Tùy chọn / theo điều kiện nguồn	Kênh khởi tạo; WEB hoặc APP. enum: WEB, APP; default: WEB
`operation_mode`	string	Tùy chọn / theo điều kiện nguồn	S: Đồng bộ; A: bất đồng bộ, mặc định A theo bảng RSS. enum: S, A; default: A
`postback_url`	string	Tùy chọn / theo điều kiện nguồn	Địa chỉ nhận kết quả phía RP; xác nhận đăng ký và kiểm tra nguồn gửi. format: uri
`user_info`	object	Bắt buộc
`user_info.citizen_pid`	string	Bắt buộc	Số định danh cá nhân; không nhập dữ liệu thật vào demo.
`user_info.full_name`	string	Tùy chọn / theo điều kiện nguồn	Họ tên nếu gửi.
`user_info.birth_date`	string	Tùy chọn / theo điều kiện nguồn	Ngày sinh theo contract triển khai.
`user_info.phone`	string	Tùy chọn / theo điều kiện nguồn	Số điện thoại nếu cần.
`user_info.email`	string	Tùy chọn / theo điều kiện nguồn	Email nếu cần.
`user_info.issuing_authority`	string	Tùy chọn / theo điều kiện nguồn	Cơ quan cấp căn cước; tùy chọn. Định dạng theo contract triển khai.
`user_info.date_of_issue`	string	Tùy chọn / theo điều kiện nguồn	Ngày cấp căn cước; tùy chọn. Định dạng theo contract triển khai.
`user_info.gender`	string	Tùy chọn / theo điều kiện nguồn	Giới tính; tùy chọn. Định dạng theo contract triển khai.
`user_info.nationality_code`	string	Tùy chọn / theo điều kiện nguồn	Mã quốc tịch; tùy chọn. Định dạng theo contract triển khai.
`user_info.permanent_address`	string	Tùy chọn / theo điều kiện nguồn	Địa chỉ thường trú; tùy chọn. Định dạng theo contract triển khai.
`user_info.permanent_village_text`	string	Tùy chọn / theo điều kiện nguồn	Tên đơn vị địa phương thường trú; tùy chọn. Định dạng theo contract triển khai.
`user_info.permanent_city_text`	string	Tùy chọn / theo điều kiện nguồn	Tên tỉnh/thành thường trú; tùy chọn. Định dạng theo contract triển khai.
`user_info.living_place_address`	string	Tùy chọn / theo điều kiện nguồn	Địa chỉ nơi ở; tùy chọn. Định dạng theo contract triển khai.
`user_info.living_place_village_text`	string	Tùy chọn / theo điều kiện nguồn	Tên đơn vị địa phương nơi ở; tùy chọn. Định dạng theo contract triển khai.
`user_info.living_place_city_code`	string	Tùy chọn / theo điều kiện nguồn	Mã tỉnh/thành nơi ở; tùy chọn. Định dạng theo contract triển khai.
`user_info.living_place_city_text`	string	Tùy chọn / theo điều kiện nguồn	Tên tỉnh/thành nơi ở; tùy chọn. Định dạng theo contract triển khai.
`user_info.id_card_expire_date`	string	Tùy chọn / theo điều kiện nguồn	Ngày hết hạn căn cước; tùy chọn. Định dạng theo contract triển khai.

Payload minh họa — Chưa chạy với dịch vụ

{
  "provider": "HUD-FPT-CA",
  "service_package_code": "DEMO_PACKAGE",
  "partner_code": "DEMO_PARTNER",
  "originator_id": "DEMO_APP",
  "user_info": {
    "citizen_pid": "DEMO_CITIZEN_ONLY"
  },
  "operation_mode": "A"
}

Phản hồi · 200

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi 200
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`status`	string	Tùy chọn / theo điều kiện nguồn	Trạng thái xử lý đăng ký.

Phản hồi · Mặc định

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi mặc định
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`code`	string	Tùy chọn / theo điều kiện nguồn	Mã lỗi theo dịch vụ; không phải HTTP status.
`message`	string	Tùy chọn / theo điều kiện nguồn	Thông báo lỗi ngắn.
`description`	string	Tùy chọn / theo điều kiện nguồn	Mô tả chi tiết nếu có.

Hành động tiếp theo

Lưu x-billcode-id, chờ người dùng và tra cứu trạng thái; không tạo lại khi kết quả chưa rõ.

GET/v1/get/credential/status

Tra cứu đăng ký credential

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

OperationId: RssGetCredentialStatus · RSS 1.11.260911 · Trang PDF: 20, 21

Trích từ nguồn; môi trường triển khai chưa xác nhận. Ví dụ đầu vào dùng để đọc và đối chiếu, chưa cấu hình gọi dịch vụ thật.

Điều kiện và xác thực

Đã gửi đăng ký và lưu x-billcode-id. Dùng mã của đăng ký cần tra cứu, không thay bằng mã yêu cầu ký. Token Bearer giữ phía máy chủ; không đưa token/SAD vào frontend hoặc log công khai.

Header theo operation
Header	Bắt buộc	Ý nghĩa
`x-billcode-id`	Có	Tham chiếu từ bước tạo credential.
`x-language`	Không	Ngôn ngữ phản hồi.
`x-rp-id`	Không	Tham chiếu do RP sinh, khác với x-billcode-id do dịch vụ sinh.

Phản hồi · 200

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Điều kiện bắt buộc của data trong bảng và ví dụ đang xử lý chưa thống nhất; schema không tự chọn một nhánh production.

Phản hồi 200
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`status`	string	Tùy chọn / theo điều kiện nguồn	Trạng thái nghiệp vụ trong nguồn.
`data`	object	Tùy chọn / theo điều kiện nguồn	Đối tượng theo bảng nguồn.
`data.citizen_pid`	string	Tùy chọn / theo điều kiện nguồn	Số định danh; điều kiện xuất hiện cần đọc cùng trạng thái.
`data.description`	string	Tùy chọn / theo điều kiện nguồn	Mô tả kết quả theo trạng thái.
`data.credential_id`	string	Tùy chọn / theo điều kiện nguồn	Mã credential khi được trả về.
`data.serial_number`	string	Tùy chọn / theo điều kiện nguồn	Số sê-ri chứng thư.
`data.certificate_data`	string	Tùy chọn / theo điều kiện nguồn	Chứng thư Base64 theo nguồn.

Phản hồi · Mặc định

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi mặc định
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`code`	string	Tùy chọn / theo điều kiện nguồn	Mã lỗi theo dịch vụ; không phải HTTP status.
`message`	string	Tùy chọn / theo điều kiện nguồn	Thông báo lỗi ngắn.
`description`	string	Tùy chọn / theo điều kiện nguồn	Mô tả chi tiết nếu có.

Điểm cần xác nhận

RSS-01
RSS-05

Hành động tiếp theo

Đối chiếu kết quả đăng ký trước khi lấy chứng thư.

POST/v1/sign/hash

Ký digest tài liệu

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

OperationId: RssSignHash · RSS 1.11.260911 · Trang PDF: 27, 28, 29, 30

Trích từ nguồn; môi trường triển khai chưa xác nhận. Ví dụ đầu vào dùng để đọc và đối chiếu, chưa cấu hình gọi dịch vụ thật.

Điều kiện và xác thực

Có credential đủ điều kiện và phiên bản tài liệu đã cố định. Chuẩn bị digest theo encoding/thuật toán được chốt; yêu cầu ký vẫn có thể cần hành động người dùng. Token Bearer giữ phía máy chủ; không đưa token/SAD vào frontend hoặc log công khai.

Header theo operation
Header	Bắt buộc	Ý nghĩa
`x-language`	Không	Ngôn ngữ phản hồi.
`x-rp-id`	Không	Tham chiếu do RP sinh, khác với x-billcode-id do dịch vụ sinh.

Yêu cầu · application/json

Cấu trúc yêu cầu
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`credential_id`	string	Bắt buộc	Identifier khóa/chứng thư được lựa chọn.
`citizen_pid`	string	Bắt buộc	Số định danh cá nhân; không nhập dữ liệu thật vào demo.
`partner_code`	string	Bắt buộc	Mã đối tác gửi yêu cầu.
`originator_id`	string	Bắt buộc	Mã định danh ứng dụng gửi yêu cầu.
`operation_mode`	string	Tùy chọn / theo điều kiện nguồn	S: Đồng bộ; A: bất đồng bộ, mặc định A theo bảng RSS. enum: S, A; default: A
`platform`	string	Tùy chọn / theo điều kiện nguồn	Kênh khởi tạo; WEB hoặc APP. enum: WEB, APP; default: WEB
`postback_url`	string	Tùy chọn / theo điều kiện nguồn	Địa chỉ nhận kết quả phía RP; xác nhận đăng ký và kiểm tra nguồn gửi. format: uri
`documents`	object[]	Bắt buộc	Danh sách tài liệu và digest; định dạng digest cần xác nhận.
`documents[].document_name`	string	Bắt buộc	Tên tài liệu.
`documents[].digest_value`	string	Bắt buộc	Digest tài liệu; không dùng tài liệu thật trong demo.

Payload minh họa — Chưa chạy với dịch vụ

{
  "credential_id": "DEMO_RSS_CREDENTIAL",
  "citizen_pid": "DEMO_CITIZEN_ONLY",
  "partner_code": "DEMO_PARTNER",
  "originator_id": "DEMO_APP",
  "documents": [
    {
      "document_name": "DEMO_DOCUMENT",
      "digest_value": "ypeBEsobvcr6wjGzmiPcTaeG7/gUfE5yuYB3ha/uSLs="
    }
  ],
  "operation_mode": "A"
}

Phản hồi · 200

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi 200
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`data`	object	Tùy chọn / theo điều kiện nguồn
`data.status`	string	Tùy chọn / theo điều kiện nguồn	Trạng thái theo bảng.
`data.signatures`	string[]	Tùy chọn / theo điều kiện nguồn	Chữ ký Base64 theo bảng; envelope cần xác nhận.
`status`	string	Tùy chọn / theo điều kiện nguồn	Trường top-level trong ví dụ nguồn; chưa xác nhận quan hệ với data.status.

Phản hồi · Mặc định

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi mặc định
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`code`	string	Tùy chọn / theo điều kiện nguồn	Mã lỗi theo dịch vụ; không phải HTTP status.
`message`	string	Tùy chọn / theo điều kiện nguồn	Thông báo lỗi ngắn.
`description`	string	Tùy chọn / theo điều kiện nguồn	Mô tả chi tiết nếu có.

Điểm cần xác nhận

RSS-01
RSS-02
RSS-04

Hành động tiếp theo

Lưu mã tham chiếu; đối soát qua callback hoặc tra cứu. Chưa coi PROCESSING là ký hoàn tất.

GET/v1/get/signing/status

Tra cứu kết quả ký

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

OperationId: RssGetSigningStatus · RSS 1.11.260911 · Trang PDF: 31, 32

Trích từ nguồn; môi trường triển khai chưa xác nhận. Ví dụ đầu vào dùng để đọc và đối chiếu, chưa cấu hình gọi dịch vụ thật.

Điều kiện và xác thực

Đã lưu x-billcode-id của yêu cầu sign/hash. Đối soát kết quả trước khi quyết định tạo một yêu cầu khác. Token Bearer giữ phía máy chủ; không đưa token/SAD vào frontend hoặc log công khai.

Header theo operation
Header	Bắt buộc	Ý nghĩa
`x-billcode-id`	Có	Tham chiếu do sign/hash trả về.
`x-language`	Không	Ngôn ngữ phản hồi.
`x-rp-id`	Không	Tham chiếu do RP sinh, khác với x-billcode-id do dịch vụ sinh.

Phản hồi · 200

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi 200
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`status`	string	Tùy chọn / theo điều kiện nguồn	Trạng thái yêu cầu ký.
`data`	object	Tùy chọn / theo điều kiện nguồn
`data.signatures`	string[]	Tùy chọn / theo điều kiện nguồn	Nguồn mô tả chưa nhất quán; chưa dùng để diễn giải kết quả mật mã.
`data.description`	string	Tùy chọn / theo điều kiện nguồn	Thông tin giải thích trong kết quả.

Phản hồi · Mặc định

HTTP status và trạng thái nghiệp vụ phải được đọc riêng.

Phản hồi mặc định
Trường	Kiểu dữ liệu	Điều kiện	Mô tả
`code`	string	Tùy chọn / theo điều kiện nguồn	Mã lỗi theo dịch vụ; không phải HTTP status.
`message`	string	Tùy chọn / theo điều kiện nguồn	Thông báo lỗi ngắn.
`description`	string	Tùy chọn / theo điều kiện nguồn	Mô tả chi tiết nếu có.

Điểm cần xác nhận

RSS-01
RSS-02

Hành động tiếp theo

Liên kết kết quả với phiên bản tài liệu; hoàn thiện và kiểm chứng theo contract.

GET/v1/get/certificates

Tra cứu chứng thư theo chủ thể

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: RSS 1.11.260911 · PDF 23,24,25,26 · trường chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Xác thực theo nguồn: Bearer

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
x-language	header	Không	string
x-rp-id	header	Không	string
x-citizen-pid	header	Có	string
x-certificate-info-enabled	header	Không	boolean
x-certificates	header	Không	string

HTTP 200

Phản hồi chứng thư và khóa
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`certificates`	array	Tùy chọn	Danh sách chứng thư từ dịch vụ.
`certificates[].status`	string	Tùy chọn	Trạng thái chứng thư trong RSS: 0 khóa, 1 hoạt động, 2 hết hạn; không phải kết quả kiểm chứng tài liệu.
`certificates[].cert_chains`	array	Bắt buộc	Chuỗi chứng thư X.509 Base64; chứng thư người ký đứng đầu theo nguồn.
`certificates[].credential_id`	string	Bắt buộc	Mã credential gắn khóa và chứng thư.
`certificates[].serial_number`	string	Có điều kiện	Số sê-ri; trả khi bật thông tin chứng thư.
`certificates[].issuer_dn`	string	Có điều kiện	Tên phân biệt của bên phát hành; có điều kiện.
`certificates[].subject_dn`	string	Có điều kiện	Tên phân biệt chủ thể; không dùng dữ liệu thật trong ví dụ.
`certificates[].valid_from`	string	Có điều kiện	Bắt đầu hiệu lực ISO 8601 UTC khi bật thông tin chứng thư.
`certificates[].valid_to`	string	Có điều kiện	Kết thúc hiệu lực ISO 8601 UTC; không thay kiểm tra thu hồi.
`key`	object	Tùy chọn
`key.status`	string	Tùy chọn	Trạng thái khóa theo nguồn; không tự tạo enum.
`key.algos`	array	Tùy chọn	OID thuật toán khóa được trả về.
`key.len`	integer	Tùy chọn	Độ dài khóa theo bit.
`key.curve`	string	Tùy chọn	Đường cong khi áp dụng.

Bước tiếp theo: Kiểm tra trạng thái nghiệp vụ và đối chiếu mã theo dõi; chỉ hoàn thiện/kiểm chứng tài liệu sau khi có đúng kết quả ký. Nếu mất phản hồi, đối soát trước khi tạo lại yêu cầu.

Nguồn dùng cả x-certificate-info-enabled và x-certificate-info-enable. Cần xác nhận tên header trước khi gọi thật; xem RSS13-CERT-HEADER. Phản hồi chứng thư không phải báo cáo kiểm chứng tài liệu.

POST/v1/request/citizen/identity-sharing

Yêu cầu đồng ý chia sẻ dữ liệu VNeID

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: RSS 1.11.260911 · PDF 33,34,35 · trường chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Xác thực theo nguồn: Bearer

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
x-language	header	Không	string
x-rp-id	header	Không	string

Đầu vào — Trường được mô tả

Content-Type: application/json

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`citizen_pid`	string	Bắt buộc	Mã định danh công dân.
`request_time`	string	Tùy chọn	Format nguồn ddMMyyyyHHmmss.
`target_code`	string · Update-info-web, update-info-app	Bắt buộc	Mục đích chia sẻ.
`postback_url`	string	Tùy chọn	URL nhận postback phía máy chủ.

HTTP 200

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Bắt buộc	Kết quả nghiệp vụ; không phải HTTP status hoặc kết quả kiểm chứng chữ ký.
`code`	string	Tùy chọn	Mã lỗi nguồn; không dịch.
`message`	string	Tùy chọn	Tóm tắt lỗi.
`description`	string	Tùy chọn	Giải thích lỗi.
`data`	object	Có điều kiện	Kết quả khởi tạo, chưa phải dữ liệu chia sẻ hoặc chữ ký.
`data.transaction_code`	string	Bắt buộc	Mã giao dịch VNeID trả về sau khởi tạo.
`data.response_time`	string	Tùy chọn	Bảng ghi String[] nhưng ví dụ là String; chưa xác nhận.

Điểm cần xác nhận: RSS12-SHARE-TYPE

GET/v1/get/citizen/identity-sharing

Đọc kết quả chia sẻ dữ liệu

Có nguồn · Đặc tả triển khai chưa xác nhận · Chưa kiểm thử sandbox

Nguồn: RSS 1.11.260911 · PDF 36,37,38 · trường chọn lọc

Điều kiện: Xác nhận phạm vi triển khai, cách xác thực và quyền sử dụng với Mobile-ID. Giữ token và dữ liệu ký phía máy chủ; không chạy từ trang demo.

Xác thực theo nguồn: Bearer

Tham số

Tham số thao tác API
Tên	Vị trí	Bắt buộc	Kiểu dữ liệu
x-language	header	Không	string
x-rp-id	header	Không	string
x-transaction-code	header	Có	string
x-request-time	header	Không	string
x-target-code	header	Có	string

HTTP 200

Các trường được biên tập từ nguồn
Trường	Kiểu dữ liệu	Điều kiện	Ý nghĩa và giới hạn
`status`	string	Bắt buộc	Kết quả nghiệp vụ; không phải HTTP status hoặc kết quả kiểm chứng chữ ký.
`code`	string	Tùy chọn	Mã lỗi nguồn; không dịch.
`message`	string	Tùy chọn	Tóm tắt lỗi.
`description`	string	Tùy chọn	Giải thích lỗi.
`data`	object	Có điều kiện	Kết quả chia sẻ; không dùng các trường công dân đầy đủ trong fixture demo.
`data.user_info_token`	string	Có điều kiện	Token chia sẻ theo JWS; kiểm tra theo hợp đồng tích hợp tin cậy đã thống nhất.
`data.response_time`	string	Tùy chọn	Thời điểm kết quả theo format nguồn.
`data.description`	string	Tùy chọn	Giải thích kết quả.

Điểm cần xác nhận: RSS12-SHARE-HEADER

Danh mục chức năng trong nguồn

Chức năng theo Specification
Chức năng	Method / path	Trang PDF	Phạm vi trang
Xác thực	`POST {sso-url}/realms/{realm}/protocol/openid-connect/token`	8	Danh mục nguồn; schema chưa chuyển đầy đủ
Thông tin hệ thống	`GET /v1/get/system/info`	9	Danh mục nguồn; schema chưa chuyển đầy đủ
Đăng ký đối tác	`POST /v1/register/partner`	12	Danh mục nguồn; schema chưa chuyển đầy đủ
Tạo credential	`POST /v1/create/credential`	15	Đọc schema trong trang
Trạng thái credential	`GET /v1/get/credential/status`	20	Đọc schema trong trang
Danh sách chứng thư	`GET /v1/get/certificates`	23	Danh mục nguồn; schema chưa chuyển đầy đủ
Ký mã băm	`POST /v1/sign/hash`	27	Đọc schema trong trang
Trạng thái ký	`GET /v1/get/signing/status`	31	Đọc schema trong trang
Yêu cầu chia sẻ danh tính	`POST /v1/request/citizen/identity-sharing`	33	Danh mục nguồn; schema chưa chuyển đầy đủ
Kết quả chia sẻ danh tính	`GET /v1/get/citizen/identity-sharing`	36	Danh mục nguồn; schema chưa chuyển đầy đủ
Danh sách giao dịch	`GET /v1/get/transactions`	39	Danh mục nguồn; schema chưa chuyển đầy đủ
Universal link của RP	`GET /v1/get/rp/universal-link`	42	Danh mục nguồn; schema chưa chuyển đầy đủ
Thông tin thuế	`GET /v1/get/tax/information`	44	Danh mục nguồn; schema chưa chuyển đầy đủ
Kết quả thông tin thuế	`GET /v1/get/tax/information/result`	54	Danh mục nguồn; schema chưa chuyển đầy đủ
Loại ứng dụng	`GET /v1/get/application/type`	62	Danh mục nguồn; schema chưa chuyển đầy đủ
Danh sách đối tác	`GET /v1/get/partners`	65	Danh mục nguồn; schema chưa chuyển đầy đủ
Xác minh định danh công dân	`POST /v1/verify/eid`	67	Danh mục nguồn; schema chưa chuyển đầy đủ
Nạp lại hệ thống	`POST /v1/reload/system`	70	Danh mục nguồn; schema chưa chuyển đầy đủ

Điểm cần chốt trước tích hợp

RSS-01 · RSS §1.4; bảng endpoint

Base URL có /v1 nhưng path cũng có /v1.

Chốt URL ghép trước cấu hình môi trường.

RSS-02 · RSS signHash / trạng thái ký, tr. thực 27–32

Bảng và ví dụ khác envelope; mô tả signatures ở tra cứu chưa rõ.

Chốt schema thành công/đang xử lý theo từng operation.

RSS-03 · RSS createCredential, tr. thực 15–19

Ví dụ thiếu các trường bắt buộc trong bảng và có trường không được liệt kê.

Ví dụ biên tập dùng trường bắt buộc; chưa phải request đã chạy.

RSS-04 · RSS signHash, tr. thực 27–30

Định dạng digest và điều kiện kết quả cần chốt cho triển khai.

Không áp dụng thuật toán/encoding của SIC sang RSS.

RSS-05 · RSS trạng thái credential, tr. thực 20–21

Bảng bắt buộc data.citizen_pid/data.description nhưng ví dụ PROCESSING thiếu data.

Điều kiện hiện diện theo trạng thái cần xác nhận; không dựng nhánh schema production.

Đối chiếu với thao tác trên Viewer

Xem bản ghi đúng tuyến, đọc kết quả và phần lược bỏ, rồi đối chiếu operation. Video không thay contract hoặc báo cáo kiểm chứng.

Xem bảy bản ghi Viewer/VNeID

RSS: Đăng ký, ký hash và đối soát

Mức bao phủ và điều kiện tích hợp

RSS, Postman và kênh sự kiện

Phạm vi và tài sản

Thao tác API và cấu trúc dữ liệu

Điều kiện và xác thực

Yêu cầu · application/json

Phản hồi · 200

Phản hồi · Mặc định

Điểm cần xác nhận

Hành động tiếp theo

Điều kiện và xác thực

Phản hồi · 200

Phản hồi · Mặc định

Điểm cần xác nhận

Hành động tiếp theo

Điều kiện và xác thực

Yêu cầu · application/json

Phản hồi · 200

Phản hồi · Mặc định

Điểm cần xác nhận

Hành động tiếp theo

Điều kiện và xác thực

Phản hồi · 200

Phản hồi · Mặc định

Điểm cần xác nhận

Hành động tiếp theo

Tham số

HTTP 200

Tham số

Đầu vào — Trường được mô tả

HTTP 200

Tham số

HTTP 200

Danh mục chức năng trong nguồn

Điểm cần chốt trước tích hợp

RSS-01 · RSS §1.4; bảng endpoint

RSS-02 · RSS signHash / trạng thái ký, tr. thực 27–32

RSS-03 · RSS createCredential, tr. thực 15–19

RSS-04 · RSS signHash, tr. thực 27–30

RSS-05 · RSS trạng thái credential, tr. thực 20–21

Chia sẻ dữ liệu: Mã theo dõi và giới hạn

Đối chiếu với thao tác trên Viewer