企微中台

# 密文 external_userid 转换为明文

请求方式： POST

请求地址： https://nbd-api.myscrm.cn/open-nbd-qw-member/v1/customer/external-userid/decrypt

请求参数说明：

参数 类型 必须 说明
app_id string 是 中台应用 id，需为密文代开发应用
cipher_ids []string 是 密文 external_userid 列表, 列表有数量上限，最多 100 个
target_qw_mgt_func int target_qw_mgt_func、target_basic_app_name 必传其一，优先使用 target_qw_mgt_func 转换为企微能力能识别的明文 id：1-客户联系；2-通讯录；3-会话存档，需完成对应企微能力的配置
target_basic_app_name string target_qw_mgt_func、target_basic_app_name 必传其一，优先使用 target_qw_mgt_func 转换为基础应用能识别的明文 id：公费电话；微信客服，需完成对应基础应用的配置

请求参数示例：

{
  "app_id": "3a04daf7-xxxx-xxxx-93b7-353ddc82cde1",
  "cipher_ids": ["wmiKodDAAAH-xxxxx1fGR_c3fKQn045A"],
  "target_qw_mgt_func": 1,
  "target_basic_app_name": "公费电话"
}

返回数据：

{
  "errcode": 0,
  "errmsg": "ok",
  "items": [
    {
      "cipher_id": "wmiKodDAAAH-xxxxx1fGR_c3fKQn045A",
      "plain_id": "wmD2JCDwAAxxxxxBdKu3TBJnzLbw"
    }
  ]
}

返回参数说明：

注意：当某一待处理id未被成功处理，结果集中不会返回该id

参数 类型 说明
items.cipher_id string 密文 external_userid
items.plain_id string 明文 external_userid

← 明文 external_userid 转换为密文 →