获取组织详情

GET

/openapi/v3/organizations/:id

获取指定组织的详细信息，包括组织基础信息、联系人、验证详情等。

路径参数

参数	类型	必填	说明
id	string	是	组织 ID

返回参数

响应数据包裹在 org_info 对象下（即 data.org_info），下列字段均为 org_info 的子字段。

参数	类型	说明
id	string	组织 ID
name	string	组织名称
address_line1	string	组织地址
address_line2	string	组织地址 2
city	string	城市
state	string	省份
zip_code	string	邮编
country	string	国家地区代码（如中国 CN）
telephone	string	组织联系电话
biz_email	string	企业邮箱
uscc	string	统一社会信用代码
verify_types	array[string]	组织验证类型（如 ov、ev、ds）
admin_user	object	联系人信息
∟ first_name	string	联系人名称
∟ last_name	string	联系人姓氏
∟ job_title	string	联系人职位
∟ telephone	string	联系人电话
∟ email	string	联系人邮箱
∟ id_type	string	证件类型（仅部分身份认证证书需要）
∟ id_number	string	证件号码（仅部分身份认证证书需要）
contact	object	联系人信息
∟ first_name	string	联系人名称
∟ last_name	string	联系人姓氏
∟ job_title	string	联系人职位
∟ telephone	string	联系人电话
∟ email	string	联系人邮箱
∟ id_type	string	证件类型（仅部分身份认证证书需要）
∟ id_number	string	证件号码（仅部分身份认证证书需要）
legal_person	object	法人信息（位于 org_info 下，仅 audit_method=legalRep 的组织返回）
∟ first_name	string	法人名称
∟ last_name	string	法人姓氏
∟ job_title	string	法人职位
∟ telephone	string	法人电话
∟ email	string	法人邮箱
∟ id_type	string	法人证件类型
∟ id_number	string	法人证件号码
provider	string	证书 CA 方
validations	array[object]	组织验证详情
∟ type	string	验证类型
∟ name	string	验证名称
∟ status	string	验证状态
∟ expire_time	string	验证过期时间
∟ created_time	string	验证创建时间
created_time	string	组织创建时间
status	string	状态
end_user_id	string	终端用户标识

请求示例

curl -G 'https://api.certcloud.cn/openapi/v3/organizations/yAvsAzQ6' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id'

const response = await fetch('https://api.certcloud.cn/openapi/v3/organizations/yAvsAzQ6', {
  method: 'GET',
  headers: {
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  }
})
const data = await response.json()

req, _ := http.NewRequest("GET", "https://api.certcloud.cn/openapi/v3/organizations/yAvsAzQ6", nil)
req.Header.Set("X-CC-Auth-Key", "your-auth-key")
req.Header.Set("X-CC-Key-ID", "your-key-id")
resp, err := http.DefaultClient.Do(req)

import requests

response = requests.get(
    'https://api.certcloud.cn/openapi/v3/organizations/yAvsAzQ6',
    headers={
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    }
)
data = response.json()

200成功

{
  "data": {
    "org_info": {
      "id": "yAvsAzQ6",
      "name": "亚数信息科技（上海）有限公司（测试）",
      "telephone": "021-58895880",
      "address_line1": "桂平路391号",
      "city": "上海市",
      "state": "上海市",
      "country": "CN",
      "zip_code": "2000000",
      "admin_user": {
        "first_name": "三",
        "last_name": "章",
        "job_title": "CEO",
        "telephone": "021-58895880",
        "id_type": "",
        "id_number": "",
        "email": "zhang.san@example.com"
      },
      "legal_person": {
        "first_name": "三",
        "last_name": "章",
        "id_type": "id_card",
        "id_number": "3101************21"
      },
      "user_id": "000000001",
      "validations": [
        {
          "type": "ov",
          "name": "ov",
          "description": "ov",
          "status": "pending",
          "created_time": "0001-01-01T00:00:00Z",
          "expire_time": "0001-01-01T00:00:00Z"
        },
        {
          "type": "ev",
          "name": "ev",
          "description": "ev",
          "status": "pending",
          "created_time": "0001-01-01T00:00:00Z",
          "expire_time": "0001-01-01T00:00:00Z"
        }
      ],
      "created_time": "2023-10-26T12:13:20Z"
    }
  },
  "code": "success"
}