删除外呼名单

服务描述

本接口,可根据某个特定任务,删除外呼任务下关联的名单。

注意事项:名单状态为未开始才可以调用。 需要未送号才能删除成功。

开发须知

调用本接口前,请先获取appId

服务地址

POST https://{您的专属域名}/outbound/openapi/v2/task/deleteAudioRecord

请求参数

参数 位置 类型 是否必填 说明
appId header String Y 应用ID
timestamp header String Y 时间戳,毫秒
sign header String Y 签名
encrypted header String N 是否需要加密,需要加密传值(加密方式):AES/REQBODY/RESP,不需要加密不用传该字段
Content-Type header String Y application/json
Body BatchDeleteAudioRecordRequest Y 名单列表,json array
BatchDeleteAudioRecordRequest
参数 类型 是否必填 说明
taskCode String(32) Y 任务编码
list List<String> Y 需要删除的外呼名单编码,最大支持2000条数据,并确保外呼名单编码唯一
加密,encrypted传值,表示需要加密,按照以下步骤加密传输

将json数据加解密工具加密后,通过body传到接口

Body数据示例:
  • 需要加密,以下是入参加密前的json
  • 不需要加密则直接传Json参数到body
{
  "taskCode": "e9a0edb5e839eada14624f83df4c4dd0",
  "list": [
    "a492e8f048d00bcc723d62719e245546",
    "a492e8f048d00bcc723d62719e245502"
  ]
}

返回结果加密

加密方式header中的encrypted传值,表示需要对返回结果进行加密,拿到加密后的返回结果, 使用私钥加解密工具进行解密

返回结果

  • 需要加密,以下是返回结果加密前的json
  • 不需要加密则直接直接返回不加密的结果
参数 类型 说明
code String 结果码
message String 结果描述
data List 名单信息
BatchDeleteAudioRecordResponse
参数 类型 说明
audioRecordCode String(32) 外呼名单编码,长度32位或外部名单code
status integer(1) 删除结果,1删除成功 0删除失败
msg String(64) 提示信息
返回结果示例:
{
  "code": "10000",
  "message": "请求成功",
    "data": [{
        "status": "1",
        "msg": "删除成功",
        "audioRecordCode": "a492e8f048d00bcc723d62719e245546"
    },
    {
      "status": "0",
      "msg": "该名单已送号,不能删除",
      "audioRecordCode": "a492e8f048d00bcc723d62719e245502"
  }]
}
结果码说明
结果码 说明
10000 请求成功
20001 请求失败
21002 认证失败,请重新登录

FAQ:

results matching ""

    No results matching ""