Skip to content

更新流量投放状态 ​

需要携带 Token,详情看 Token

通过此接口可用于控制流量(即,mtgid)在广告单元中的跑量状态。另外,该操作受权限管控,若权限不足,接口会返"Permission denied",请联系 AM 授权后再试操作。

请求地址 ​

https://ss-api.mintegral.com/api/open/v1/offer/target

请求方法 ​

PUT

请求示例 ​

json
PUT /api/open/v1/offer/target
HTTP/1.1 Host: ss-api.mintegral.com
Content-Type: application/json
{ 
  "offer_id": 1234, 
  "option": "ENABLE", 
  "mtgid":  "mtg1127838375" 
}

请求参数 ​

字段类型说明默认值例子
offer_idint广告单元 ID—1234
optionstring广告单元下需要优化的流量的 mtgid 的新状态。可选值:"ENABLE" 、"DISABLE" 、"ALLOW_ALL"。
ENABLE :表示将某个 mtgid 添加进白名单或者将某个 mtgid 从黑名单剔除
DISABLE : 表示将某个 mtgid 添加进黑名单或者将某个 mtgid 从白名单剔除。
ALLOW_ALL:表示恢复所有 App 的投放状态,取消黑白名单的设置。 
广告单元里需要优化的流量 mtgid。如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。
—"DISABLE"
mtgidstring广告单元里需要优化的流量 mtgid。仅option 传 "ALLOW_ALL" 时,mtgid 可传空,如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。
注: 该接口采取全量更新方式,请提交完整的黑白名单设置。
—"mtg1127838375"

响应结果 ​

字段类型说明
codeint200 表示成功 其他表示失败
msgstring成功,返回"success",失败返回相应的错误信息
datajson成功,返回 null,失败返回具体的错误信息

应答示例 ​

json
{
  "msg": "success",
  "code": 200,
  "data": null
}