{
  "openapi": "3.0.3",
  "info": {
    "title": "Trusted SIC — compact documentary subset",
    "version": "1.7.261001-documentary",
    "description": "Source: Trusted SIC Service API Specifications, Compact document, 1.7.261001. Eight REST operations catalogued, selected field structures only. No deployment server is configured; source contradictions remain unresolved."
  },
  "servers": [],
  "paths": {
    "/v2/auth/login": {
      "post": {
        "operationId": "sicCompactLogin",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Authenticate application",
        "x-summary-vi": "Xác thực ứng dụng",
        "description": "Authenticate application. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            6
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-LOGIN"
        ],
        "security": [
          {
            "basic": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "refresh_token": {
                    "type": "string",
                    "description": "Conditional refresh credential; Basic versus refresh selection needs confirmation.",
                    "x-description-vi": "Thông tin làm mới có điều kiện; cần xác nhận cách chọn Basic hoặc refresh.",
                    "x-presence": "RC"
                  },
                  "rememberMe": {
                    "type": "string",
                    "description": "Source table uses String; the example uses a Boolean.",
                    "x-description-vi": "Bảng nguồn ghi String nhưng ví dụ dùng Boolean.",
                    "x-presence": "O"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "access_token": {
                      "type": "string",
                      "description": "Application access token; store on the backend.",
                      "x-description-vi": "Token ứng dụng; lưu phía máy chủ.",
                      "x-presence": "M"
                    },
                    "refresh_token": {
                      "type": "string",
                      "description": "Refresh token.",
                      "x-description-vi": "Token làm mới.",
                      "x-presence": "O"
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Lifetime of the service access token in seconds; source §3.1.1, PDF 7.",
                      "x-description-vi": "Thời hạn access_token tính bằng giây; nguồn §3.1.1, PDF 7.",
                      "x-presence": "O"
                    }
                  },
                  "required": [
                    "access_token"
                  ]
                }
              }
            },
            "headers": {
              "x-billcode-id": {
                "description": "Service-generated tracing identifier; source §3.1.1, PDF 6–7.",
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              6
            ]
          },
          "blocking_issues": [
            "SIC12-LOGIN"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/auth/revoke": {
      "post": {
        "operationId": "sicCompactRevoke",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Revoke an application token",
        "x-summary-vi": "Thu hồi token ứng dụng",
        "description": "Revoke an application token. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            8
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "token": {
                    "type": "string",
                    "description": "Token to revoke.",
                    "x-description-vi": "Token cần thu hồi.",
                    "x-presence": "M"
                  },
                  "token_type_hint": {
                    "type": "string",
                    "description": "Token-type hint.",
                    "x-description-vi": "Gợi ý loại token.",
                    "x-presence": "O"
                  }
                },
                "required": [
                  "token"
                ]
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "No content (source example)."
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              8
            ]
          },
          "blocking_issues": [],
          "response_model": "catalogue-or-description"
        }
      }
    },
    "/v2/credentials/issue": {
      "post": {
        "operationId": "sicCompactIssue",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Issue a credential",
        "x-summary-vi": "Phát hành credential",
        "description": "Issue a credential. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            9
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-MODE",
          "SIC12-VIEW"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "alias": {
                    "type": "string",
                    "description": "Optional alias.",
                    "x-description-vi": "Tên thay thế tùy chọn.",
                    "x-presence": "O"
                  },
                  "citizenId": {
                    "type": "string",
                    "description": "Required conditionally for synchronous issuance; mode mapping is contradictory.",
                    "x-description-vi": "Bắt buộc có điều kiện khi phát hành đồng bộ; mã chế độ đang mâu thuẫn.",
                    "x-presence": "RC"
                  },
                  "packageId": {
                    "type": "string",
                    "description": "Required conditionally for synchronous issuance.",
                    "x-description-vi": "Bắt buộc có điều kiện khi phát hành đồng bộ.",
                    "x-presence": "RC"
                  },
                  "operationMode": {
                    "type": "string",
                    "description": "Issue table: S asynchronous / A synchronous; response tables conflict.",
                    "x-description-vi": "Bảng issue: S bất đồng bộ / A đồng bộ; bảng kết quả có mô tả khác.",
                    "x-presence": "O",
                    "enum": [
                      "S",
                      "A"
                    ]
                  },
                  "sharedMode": {
                    "type": "string",
                    "description": "Sharing model from the agreed configuration.",
                    "x-description-vi": "Mô hình chia sẻ theo cấu hình đã thống nhất.",
                    "x-presence": "O"
                  },
                  "SCAL": {
                    "type": "string",
                    "description": "Source binding level; not a certification claim.",
                    "x-description-vi": "Mức liên kết theo nguồn; không phải tuyên bố chứng nhận.",
                    "x-presence": "O",
                    "enum": [
                      "1",
                      "2"
                    ]
                  },
                  "agreementUUID": {
                    "type": "string",
                    "description": "Caller agreement data.",
                    "x-description-vi": "Dữ liệu thỏa thuận phía gọi.",
                    "x-presence": "O"
                  },
                  "view": {
                    "type": "object",
                    "properties": {
                      "lang": {
                        "type": "string",
                        "description": "UI language.",
                        "x-description-vi": "Ngôn ngữ giao diện.",
                        "x-presence": "O",
                        "enum": [
                          "VI",
                          "EN"
                        ]
                      },
                      "expiresIn": {
                        "type": "integer",
                        "description": "Unit is unresolved in the source; do not infer a duration.",
                        "x-description-vi": "Đơn vị chưa rõ trong nguồn; không tự suy thời hạn.",
                        "x-presence": "O"
                      },
                      "callbackUrl": {
                        "type": "string",
                        "description": "Backend result callback URL.",
                        "x-description-vi": "URL nhận kết quả tại máy chủ.",
                        "x-presence": "O"
                      },
                      "redirectUrl": {
                        "type": "string",
                        "description": "Browser redirect URL; not proof of completion.",
                        "x-description-vi": "URL chuyển hướng trình duyệt; không phải bằng chứng hoàn tất.",
                        "x-presence": "O"
                      },
                      "fontSize": {
                        "type": "string",
                        "description": "View font size.",
                        "x-description-vi": "Cỡ chữ trong giao diện.",
                        "x-presence": "O"
                      },
                      "templateUiId": {
                        "type": "string",
                        "description": "UI template identifier.",
                        "x-description-vi": "Mã mẫu giao diện.",
                        "x-presence": "O"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "default": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "View token when a UI is used; response conditions need confirmation.",
                      "x-description-vi": "Token giao diện khi dùng UI; điều kiện trả về cần xác nhận.",
                      "x-presence": "RC"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              9
            ]
          },
          "blocking_issues": [
            "SIC12-MODE",
            "SIC12-VIEW"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/credentials/list": {
      "post": {
        "operationId": "sicCompactList",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "List credentials for an owner",
        "x-summary-vi": "Liệt kê credential của chủ thể",
        "description": "List credentials for an owner. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            13
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-NAMESPACE"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "userID": {
                    "type": "string",
                    "description": "Identity identifier of the credential owner.",
                    "x-description-vi": "Mã định danh chủ thể credential.",
                    "x-presence": "M"
                  },
                  "credentialInfo": {
                    "type": "boolean",
                    "description": "Include credential information.",
                    "x-description-vi": "Kèm thông tin credential.",
                    "x-presence": "O"
                  },
                  "certificates": {
                    "type": "string",
                    "description": "Certificate chain selection.",
                    "x-description-vi": "Lựa chọn chuỗi chứng thư.",
                    "x-presence": "O",
                    "enum": [
                      "none",
                      "single",
                      "chain"
                    ]
                  },
                  "certInfo": {
                    "type": "boolean",
                    "description": "Include certificate fields.",
                    "x-description-vi": "Kèm trường thông tin chứng thư.",
                    "x-presence": "O"
                  },
                  "authInfo": {
                    "type": "boolean",
                    "description": "Include authorization mechanism information.",
                    "x-description-vi": "Kèm cơ chế cấp quyền.",
                    "x-presence": "O"
                  },
                  "onlyValid": {
                    "type": "boolean",
                    "description": "Filter usable credentials; not a signature validation result.",
                    "x-description-vi": "Lọc credential có thể sử dụng; không phải kết quả kiểm chứng chữ ký.",
                    "x-presence": "O"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Response language.",
                    "x-description-vi": "Ngôn ngữ kết quả.",
                    "x-presence": "O",
                    "enum": [
                      "VI",
                      "EN"
                    ]
                  }
                },
                "required": [
                  "userID"
                ]
              },
              "example": {
                "userID": "DEMO-OWNER",
                "certificates": "single",
                "onlyValid": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "credentialIDs": {
                      "type": "array",
                      "description": "Credential identifiers.",
                      "x-description-vi": "Các mã credential.",
                      "x-presence": "M",
                      "items": {
                        "type": "string"
                      }
                    },
                    "credentialInfos": {
                      "type": "array",
                      "description": "Conditional credential information objects; partial schema.",
                      "x-description-vi": "Thông tin credential có điều kiện; schema một phần.",
                      "x-presence": "RC",
                      "items": {
                        "type": "object"
                      }
                    }
                  },
                  "required": [
                    "credentialIDs"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "parameters": [
          {
            "in": "header",
            "name": "x-page-no",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Page number, 1-based in the source."
          },
          {
            "in": "header",
            "name": "x-records-per-page",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Requested page size; no operational limit inferred."
          }
        ],
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              13
            ]
          },
          "blocking_issues": [
            "SIC12-NAMESPACE"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/credentials/info": {
      "post": {
        "operationId": "sicCompactInfo",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Inspect a credential before authorization",
        "x-summary-vi": "Kiểm tra credential trước cấp quyền",
        "description": "Inspect a credential before authorization. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            18
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-MULTISIGN"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier; keep distinct from a certificate and a transaction.",
                    "x-description-vi": "Mã credential; phân biệt với chứng thư và giao dịch.",
                    "x-presence": "M"
                  },
                  "certificates": {
                    "type": "string",
                    "description": "Certificate chain selection.",
                    "x-description-vi": "Lựa chọn chuỗi chứng thư.",
                    "x-presence": "O",
                    "enum": [
                      "none",
                      "single",
                      "chain"
                    ]
                  },
                  "certInfo": {
                    "type": "boolean",
                    "description": "Include certificate fields.",
                    "x-description-vi": "Kèm thông tin chứng thư.",
                    "x-presence": "O"
                  },
                  "authInfo": {
                    "type": "boolean",
                    "description": "Include authorization mechanism.",
                    "x-description-vi": "Kèm cơ chế cấp quyền.",
                    "x-presence": "O"
                  },
                  "lang": {
                    "type": "string",
                    "description": "Response language.",
                    "x-description-vi": "Ngôn ngữ kết quả.",
                    "x-presence": "O"
                  }
                },
                "required": [
                  "credentialID"
                ]
              },
              "example": {
                "credentialID": "DEMO-CREDENTIAL",
                "certInfo": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "multisign": {
                      "type": "string",
                      "description": "Maximum signatures: source table uses String while an example uses a number.",
                      "x-description-vi": "Số chữ ký tối đa: bảng ghi String nhưng ví dụ dùng số.",
                      "x-presence": "O"
                    },
                    "SCAL": {
                      "type": "string",
                      "description": "Hash/SAD binding level.",
                      "x-description-vi": "Mức liên kết hash/SAD.",
                      "x-presence": "O",
                      "enum": [
                        "1",
                        "2"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              18
            ]
          },
          "blocking_issues": [
            "SIC12-MULTISIGN"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/credentials/authorize": {
      "post": {
        "operationId": "sicCompactAuthorize",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Authorize the exact digests",
        "x-summary-vi": "Cấp quyền cho đúng các digest",
        "description": "Authorize the exact digests. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            22
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-VIEW",
          "SIC12-EXPIRES",
          "SIC12-SAD"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier; keep distinct from a certificate and a transaction.",
                    "x-description-vi": "Mã credential; phân biệt với chứng thư và giao dịch.",
                    "x-presence": "M"
                  },
                  "numSignatures": {
                    "type": "integer",
                    "description": "Number of signatures requested; no unpublished limit inferred.",
                    "x-description-vi": "Số chữ ký yêu cầu; không suy giới hạn chưa công bố.",
                    "x-presence": "M"
                  },
                  "documentDigests": {
                    "type": "object",
                    "properties": {
                      "hashes": {
                        "type": "array",
                        "description": "Base64 digests bound to authorization.",
                        "x-description-vi": "Các digest Base64 được liên kết với cấp quyền.",
                        "x-presence": "M",
                        "items": {
                          "type": "string"
                        }
                      },
                      "hashAlgorithmOID": {
                        "type": "string",
                        "description": "Digest algorithm OID; agree with the signing service.",
                        "x-description-vi": "OID thuật toán digest; phải khớp dịch vụ ký.",
                        "x-presence": "M"
                      }
                    },
                    "required": [
                      "hashes",
                      "hashAlgorithmOID"
                    ],
                    "description": "Digests to bind to authorization.",
                    "x-description-vi": "Digest cần liên kết với cấp quyền.",
                    "x-presence": "M"
                  },
                  "description": {
                    "type": "string",
                    "description": "Human-readable transaction description.",
                    "x-description-vi": "Mô tả giao dịch cho người dùng.",
                    "x-presence": "O"
                  },
                  "agreementUUID": {
                    "type": "string",
                    "description": "Caller agreement data.",
                    "x-description-vi": "Dữ liệu thỏa thuận phía gọi.",
                    "x-presence": "O"
                  },
                  "username": {
                    "type": "string",
                    "description": "Management-session username.",
                    "x-description-vi": "Tên người dùng trong phiên quản lý.",
                    "x-presence": "O"
                  },
                  "clientInfo": {
                    "type": "object",
                    "properties": {
                      "application": {
                        "type": "string",
                        "description": "Application name.",
                        "x-description-vi": "Tên ứng dụng.",
                        "x-presence": "O"
                      }
                    }
                  },
                  "view": {
                    "type": "object",
                    "properties": {
                      "lang": {
                        "type": "string",
                        "description": "UI language.",
                        "x-description-vi": "Ngôn ngữ giao diện.",
                        "x-presence": "O",
                        "enum": [
                          "VI",
                          "EN"
                        ]
                      },
                      "expiresIn": {
                        "type": "integer",
                        "description": "Unit is unresolved in the source; do not infer a duration.",
                        "x-description-vi": "Đơn vị chưa rõ trong nguồn; không tự suy thời hạn.",
                        "x-presence": "O"
                      },
                      "callbackUrl": {
                        "type": "string",
                        "description": "Backend result callback URL.",
                        "x-description-vi": "URL nhận kết quả tại máy chủ.",
                        "x-presence": "O"
                      },
                      "redirectUrl": {
                        "type": "string",
                        "description": "Browser redirect URL; not proof of completion.",
                        "x-description-vi": "URL chuyển hướng trình duyệt; không phải bằng chứng hoàn tất.",
                        "x-presence": "O"
                      },
                      "fontSize": {
                        "type": "string",
                        "description": "View font size.",
                        "x-description-vi": "Cỡ chữ trong giao diện.",
                        "x-presence": "O"
                      },
                      "templateUiId": {
                        "type": "string",
                        "description": "UI template identifier.",
                        "x-description-vi": "Mã mẫu giao diện.",
                        "x-presence": "O"
                      }
                    }
                  }
                },
                "required": [
                  "credentialID",
                  "numSignatures",
                  "documentDigests"
                ]
              },
              "example": {
                "credentialID": "DEMO-CREDENTIAL",
                "numSignatures": 1,
                "documentDigests": {
                  "hashes": [
                    "ypeBEsobvcr6wjGzmiPcTaeG7/gUfE5yuYB3ha/uSLs="
                  ],
                  "hashAlgorithmOID": "2.16.840.1.101.3.4.2.1"
                }
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Token used to open authorization view. This is not a SAD.",
                      "x-description-vi": "Token mở giao diện cấp quyền. Đây chưa phải SAD.",
                      "x-presence": "M"
                    }
                  },
                  "required": [
                    "token"
                  ]
                },
                "example": {
                  "token": "DEMO-AUTHORIZATION-VIEW"
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              22
            ]
          },
          "blocking_issues": [
            "SIC12-VIEW",
            "SIC12-EXPIRES",
            "SIC12-SAD"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/signatures/signHash": {
      "post": {
        "operationId": "sicCompactSignHash",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Sign digests with valid authorization",
        "x-summary-vi": "Ký digest đã được cấp quyền",
        "description": "Sign digests with valid authorization. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            24
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-SIGNALGO",
          "SIC12-SPELLING",
          "SIC12-POLLING"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "credentialID": {
                    "type": "string",
                    "description": "Credential identifier; keep distinct from a certificate and a transaction.",
                    "x-description-vi": "Mã credential; phân biệt với chứng thư và giao dịch.",
                    "x-presence": "M"
                  },
                  "SAD": {
                    "type": "string",
                    "description": "Signature Activation Data obtained after authorization; keep on the backend.",
                    "x-description-vi": "Signature Activation Data sau cấp quyền; lưu phía máy chủ.",
                    "x-presence": "M"
                  },
                  "hashes": {
                    "type": "array",
                    "description": "Base64 digests to sign; must match authorized input.",
                    "x-description-vi": "Digest Base64 cần ký; phải khớp đầu vào đã cấp quyền.",
                    "x-presence": "M",
                    "items": {
                      "type": "string"
                    }
                  },
                  "hashAlgorithmOID": {
                    "type": "string",
                    "description": "Digest algorithm OID.",
                    "x-description-vi": "OID thuật toán digest.",
                    "x-presence": "M"
                  },
                  "signAlgo": {
                    "type": "string",
                    "description": "Signing algorithm identifier required by the table but missing in the source example.",
                    "x-description-vi": "Mã thuật toán ký: bảng bắt buộc nhưng ví dụ nguồn thiếu.",
                    "x-presence": "M"
                  },
                  "operationMode": {
                    "type": "string",
                    "description": "Sign table: A asynchronous / S synchronous; distinguish issue mapping.",
                    "x-description-vi": "Bảng sign: A bất đồng bộ / S đồng bộ; không dùng chung cách diễn giải với issue.",
                    "x-presence": "O",
                    "enum": [
                      "A",
                      "S"
                    ]
                  },
                  "validityUeriod": {
                    "type": "integer",
                    "description": "Source spelling, validity in milliseconds. Do not silently rename.",
                    "x-description-vi": "Giữ cách viết trong nguồn; thời hạn tính bằng mili giây. Không tự đổi tên.",
                    "x-presence": "O"
                  },
                  "responseUri": {
                    "type": "string",
                    "description": "Callback URI described by the signing operation.",
                    "x-description-vi": "URI nhận kết quả theo operation ký.",
                    "x-presence": "O"
                  }
                },
                "required": [
                  "credentialID",
                  "SAD",
                  "hashes",
                  "hashAlgorithmOID",
                  "signAlgo"
                ]
              }
            }
          }
        },
        "responses": {
          "default": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "signatures": {
                      "type": "array",
                      "description": "Signature data; assembling a document is a separate step.",
                      "x-description-vi": "Dữ liệu chữ ký; hoàn thiện tài liệu là bước riêng.",
                      "x-presence": "RC",
                      "items": {
                        "type": "string"
                      }
                    },
                    "responseID": {
                      "type": "string",
                      "description": "Asynchronous response identifier; not interchangeable with requestID.",
                      "x-description-vi": "Mã kết quả bất đồng bộ; không thay thế requestID.",
                      "x-presence": "RC"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              24
            ]
          },
          "blocking_issues": [
            "SIC12-SIGNALGO",
            "SIC12-SPELLING",
            "SIC12-POLLING"
          ],
          "response_model": "selected-fields"
        }
      }
    },
    "/v2/owner/management": {
      "post": {
        "operationId": "sicCompactManagement",
        "tags": [
          "Trusted SIC"
        ],
        "summary": "Open owner management",
        "x-summary-vi": "Mở quản lý chủ thể",
        "description": "Open owner management. Selected source fields, not an exhaustive contract.",
        "x-source": {
          "document": "Trusted SIC 1.7.261001 (Compact document)",
          "physicalPages": [
            26
          ]
        },
        "x-status": "source-derived-deployment-unconfirmed",
        "x-coverage": "selected-fields",
        "x-issues": [
          "SIC12-VIEW",
          "SIC12-EXPIRES"
        ],
        "security": [
          {
            "bearer": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "username": {
                    "type": "string",
                    "description": "Username for the management session.",
                    "x-description-vi": "Tên người dùng cho phiên quản lý.",
                    "x-presence": "O"
                  },
                  "view": {
                    "type": "object",
                    "properties": {
                      "lang": {
                        "type": "string",
                        "description": "UI language.",
                        "x-description-vi": "Ngôn ngữ giao diện.",
                        "x-presence": "O",
                        "enum": [
                          "VI",
                          "EN"
                        ]
                      },
                      "expiresIn": {
                        "type": "integer",
                        "description": "Unit is unresolved in the source; do not infer a duration.",
                        "x-description-vi": "Đơn vị chưa rõ trong nguồn; không tự suy thời hạn.",
                        "x-presence": "O"
                      },
                      "callbackUrl": {
                        "type": "string",
                        "description": "Backend result callback URL.",
                        "x-description-vi": "URL nhận kết quả tại máy chủ.",
                        "x-presence": "O"
                      },
                      "redirectUrl": {
                        "type": "string",
                        "description": "Browser redirect URL; not proof of completion.",
                        "x-description-vi": "URL chuyển hướng trình duyệt; không phải bằng chứng hoàn tất.",
                        "x-presence": "O"
                      },
                      "fontSize": {
                        "type": "string",
                        "description": "View font size.",
                        "x-description-vi": "Cỡ chữ trong giao diện.",
                        "x-presence": "O"
                      },
                      "templateUiId": {
                        "type": "string",
                        "description": "UI template identifier.",
                        "x-description-vi": "Mã mẫu giao diện.",
                        "x-presence": "O"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Source outcome; inspect business state separately.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "type": "string",
                      "description": "Management view token.",
                      "x-description-vi": "Token giao diện quản lý.",
                      "x-presence": "M"
                    },
                    "expires_in": {
                      "type": "integer",
                      "description": "Token expiry value.",
                      "x-description-vi": "Giá trị thời hạn token.",
                      "x-presence": "M"
                    }
                  },
                  "required": [
                    "token",
                    "expires_in"
                  ]
                }
              }
            }
          },
          "401": {
            "description": "Not authenticated; source error code variants must be confirmed."
          }
        },
        "x-readiness": {
          "documented": true,
          "contract_confirmed": false,
          "sandbox_tested": false,
          "production_accepted": false,
          "request_model": "wire-schema-selected-fields",
          "source": {
            "document": "Trusted SIC 1.7.261001 (Compact document)",
            "physicalPages": [
              26
            ]
          },
          "blocking_issues": [
            "SIC12-VIEW",
            "SIC12-EXPIRES"
          ],
          "response_model": "selected-fields"
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basic": {
        "type": "http",
        "scheme": "basic"
      },
      "bearer": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "x-source-version": "1.7.261001",
  "x-documentary": true,
  "x-coverage": "All 8 REST operations, partial field schemas; 3 views, 3 redirects and 4 callbacks documented separately."
}