批量更新创意组件电话直呼
HTTP请求方式
POST
请求地址
https://api.e.360.cn/dianjing/mobile/updatePhone
| 字段 |
类型 |
必须 |
描述 |
| apiKey |
String |
Yes |
注册时分配到的api key，该参数作为HTTP HEAD字段传递。 |
| accessToken |
String |
Yes |
身份认证通过后平台分配的临时token，作为操作对应广告账户的凭证，10小时有效。参数获取方式见接口clientLogin |
Body 请求参数
| 字段 |
类型 |
必须 |
描述 |
| phones |
String |
Yes |
JSON 格式的移动推广电话对象数组，单次请求提交数量最多 500 个。每个子链对象必须包含 id，以及推广电话(phone)、启用暂停（status）2 个属性中的 1 个。如[{"id":123456,"phone":"010-58788888"},{"id":232256, "status":"pause"}] |
请求示例
curl -X POST \
--header 'apiKey:APIKEY' \
--header 'accessToken:ACCESSTOKEN' \
--data 'phones=[{"id":6908246634,"phone":"010-58788888"}]' \
'https://api.e.360.cn/dianjing/mobile/updatePhone'
返回结果
{
"affectedRecords": 1,
"failMobileSublinkPhoneIds": "[]",
"failures": []
}
返回结果说明
| 字段 |
类型 |
描述 |
| affectedRecords |
int |
更新成功的移动电话直呼个数 |
| failMobileSublinkPhoneIds |
string |
如果部分移动电话直呼提交的数据不合法，相应的id会再返回结果中列出，不影响其他物料的更新。 |
| code |
int |
未成功更新的移动电话直呼对应的错误代码 |
| description |
string |
定位错误位置，采用 ognl 方式描述，可以定位到哪个输入参数引发错误 |
| message |
string |
错误信息 |