创建组织

POST

/openapi/v3/organizations

当不传 id 时，系统会在当前 API 账户内查找可复用组织。匹配维度与创建订单一致，包括组织名称、国家或地区、证书提供商（CA）、组织联系人邮箱，以及传入的 end_user_id；地址、城市和组织电话不参与匹配。匹配到可复用组织时返回该组织，否则创建新组织。

多租户平台必须为每个终端用户传入稳定且唯一的 end_user_id。该标识会参与自动匹配，隔离不同终端用户的预审核组织；未传时，自动匹配不具备租户隔离能力，请勿跨租户复用组织。

当传 id 时，该接口修改对应的组织信息。组织进入审核流程后，修改不会直接生效，系统会暂存变更并按审核流程处理。

详细流程参考 组织审核流程。

Body 参数 application/json

参数	类型	必填	说明
id	string	否	组织 ID，不为空时是修改该组织
name	string	是	组织名称，最长 200 个 Unicode 字符
address_line1	string	是	组织地址，最长 128 个 Unicode 字符
address_line2	string	否	组织地址 2；地址过长时可拆分填写，最长 64 个 Unicode 字符
city	string	是	城市，最长 64 个 Unicode 字符
state	string	是	省份，最长 64 个 Unicode 字符
zip_code	string	是	邮编，最长 40 个 Unicode 字符
country	string	是	两位国家或地区代码，如 CN
telephone	string	是	组织联系电话，最长 32 个 Unicode 字符
verify_types	array[string]	按需	组织验证类型；传入 product_id 时自动填充
admin_user	object	是	联系人信息
∟ first_name	string	是	联系人名称，最长 128 个 Unicode 字符
∟ last_name	string	是	联系人姓氏，最长 128 个 Unicode 字符
∟ job_title	string	是	联系人职位，最长 64 个 Unicode 字符
∟ telephone	string	是	联系人电话，最长 32 个 Unicode 字符
∟ email	string	是	联系人邮箱，最长 255 个 Unicode 字符
∟ id_type	string	否	证件类型，最长 32 个 Unicode 字符
∟ id_number	string	否	证件号码，最长 128 个 Unicode 字符
end_user_id	string	否	终端用户标识，最长 128 个 Unicode 字符；多租户平台必须传入稳定且唯一的值，用于隔离组织自动匹配，避免跨租户复用
provider	string	按需	证书提供商；未传 product_id 时需要提供，以可购买产品支持为准
biz_email	string	否	企业邮箱，最长 255 个 Unicode 字符
product_id	string	否	产品 ID，用于自动设置 CA 和验证类型
audit_method	string	否	组织信息审核方式（见下方说明）

关于 audit_method

组织信息审核方式可选值如下（不传则由所选产品的默认策略决定）：

取值	说明
publicEmail	公开邮箱
publicPhone	公开电话

返回数据

参数	类型	说明
data	object	组织信息直接位于响应 data 下，字段结构参见获取组织详情

请求示例

curl -X POST 'https://api.certcloud.cn/openapi/v3/organizations' \
  -H 'Content-Type: application/json' \
  -H 'X-CC-Auth-Key: your-auth-key' \
  -H 'X-CC-Key-ID: your-key-id' \
  -d '{
    "name": "亚数信息科技（上海）有限公司（测试）",
    "address_line1": "桂平路391号",
    "city": "上海市",
    "state": "上海市",
    "zip_code": "2000000",
    "country": "CN",
    "telephone": "021-58895880",
    "verify_types": ["ov", "ev"],
    "admin_user": {
      "first_name": "三",
      "last_name": "章",
      "job_title": "CEO",
      "telephone": "18989898989",
      "email": "zhang.san@example.com"
    },
    "end_user_id": "000000001",
    "provider": "digicert"
  }'

const response = await fetch('https://api.certcloud.cn/openapi/v3/organizations', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-CC-Auth-Key': 'your-auth-key',
    'X-CC-Key-ID': 'your-key-id',
  },
  body: JSON.stringify({
    name: '亚数信息科技（上海）有限公司（测试）',
    address_line1: '桂平路391号',
    city: '上海市',
    state: '上海市',
    zip_code: '2000000',
    country: 'CN',
    telephone: '021-58895880',
    verify_types: ['ov', 'ev'],
    admin_user: {
      first_name: '三',
      last_name: '章',
      job_title: 'CEO',
      telephone: '18989898989',
      email: 'zhang.san@example.com'
    },
    end_user_id: '000000001',
    provider: 'digicert'
  })
})
const data = await response.json()

body := map[string]interface{}{
  "name": "亚数信息科技（上海）有限公司（测试）",
  "address_line1": "桂平路391号",
  "city": "上海市",
  "state": "上海市",
  "zip_code": "2000000",
  "country": "CN",
  "telephone": "021-58895880",
  "verify_types": []string{"ov", "ev"},
  "admin_user": map[string]string{
    "first_name": "三",
    "last_name": "章",
    "job_title": "CEO",
    "telephone": "18989898989",
    "email": "zhang.san@example.com",
  },
  "end_user_id": "000000001",
  "provider": "digicert",
}
jsonBody, _ := json.Marshal(body)
req, _ := http.NewRequest("POST", "https://api.certcloud.cn/openapi/v3/organizations", bytes.NewBuffer(jsonBody))
req.Header.Set("Content-Type", "application/json")
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.post(
    'https://api.certcloud.cn/openapi/v3/organizations',
    headers={
        'Content-Type': 'application/json',
        'X-CC-Auth-Key': 'your-auth-key',
        'X-CC-Key-ID': 'your-key-id',
    },
    json={
        'name': '亚数信息科技（上海）有限公司（测试）',
        'address_line1': '桂平路391号',
        'city': '上海市',
        'state': '上海市',
        'zip_code': '2000000',
        'country': 'CN',
        'telephone': '021-58895880',
        'verify_types': ['ov', 'ev'],
        'admin_user': {
            'first_name': '三',
            'last_name': '章',
            'job_title': 'CEO',
            'telephone': '18989898989',
            'email': 'zhang.san@example.com'
        },
        'end_user_id': '000000001',
        'provider': 'digicert'
    }
)
data = response.json()

200成功

{
  "data": {
    "id": "yAvsAzQ6",
    "name": "亚数信息科技（上海）有限公司（测试）",
    "verify_types": ["ov", "ev"]
  },
  "code": "success"
}