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广告单元 ID1234
optionstring广告单元下需要优化的流量的 mtgid 的新状态。可选值:"ENABLE" 、"DISABLE" 、"ALLOW_ALL"
ENABLE :表示将某个 mtgid 添加进白名单或者将某个 mtgid 从黑名单剔除
DISABLE : 表示将某个 mtgid 添加进黑名单或者将某个 mtgid 从白名单剔除。
ALLOW_ALL:表示恢复所有 App 的投放状态,取消黑白名单的设置。 
广告单元里需要优化的流量 mtgid。如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。
"DISABLE"
mtgidstring广告单元里需要优化的流量 mtgid。如果 mtgid 传空,则清空黑白名单。多个用,号分隔,最多 3000 个。
注: 该接口采取全量更新方式,请提交完整的黑白名单设置。
"mtg1127838375"

响应结果

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

应答示例

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