王尘宇

请求URL

Marketing API 请求URL约定了使用的协议、域名、模块、版本、资源及动作，详细定义如下：

正式环境为 https://marketing-api.vivo.com.cn/openapi/<API_VERSION>/<RESOURCE_NAME>/<RESOURCE_ACTION>

沙箱环境为 https://sandbox-marketing-api.vivo.com.cn/openapi/<API_VERSION>/<RESOURCE_NAME>/<RESOURCE_ACTION>

其中：

协议：正式环境和沙箱环境均使用 HTTPS；

API_VERSION：版本号，当前最新版本号为 v1；

RESOURCE_NAME：表示要操作的资源，如campaigns、adcreatives，可能是一级，也可能是二级，以最终请求url里的为准；

RESOURCE_ACTION：表示对资源的动作，如 query、add及modify。

各接口对应的 <RESOURCE_NAME>/<RESOURCE_ACTION> 在文档中描述为接口请求路径，例如：正式环境新建一个创意，接口文档中描述的请求路径为 /ad/creative/add，完整地址为 https://marketing-api.vivo.com.cn/openapi/v1/ad/creative/add。

HTTP Method

调用方应根据具体接口的要求设置 HTTP Method为 GET或POST。

HTTP Header

调用方应遵循HTTP协议设置相应的 Header，目前支持的Header有：Content-Type，用于指定数据格式。例如：Content-Type: application/json

编码方式

Marketing API支持的编码方式为 UTF-8。

接口调用限制

类别	限制描述
接口功能	不同应用程序在接口功能上可能存在差异，由开发者创建应用的时候根据应用的使用场景进行选择
调用天频次	1、达到限制后，您当日将无法继续调用超限的接口，第二天可自动恢复正常 2、如需要调整限制可以联系您的运营接口人
调用分钟频次	1、系统对每个应用程序调用每个接口都有调用分钟频次限制，不同应用等级下的调用次数不同，具体可通过应用程序管理页面了解 2、达到限制后，您需要暂停对该接口的调用，1分钟后可自动恢复正常 3、如需要调整限制可以联系您的运营接口人

特殊字符限制

如无特殊声明，API接口所有输入参数的值均不能包含以下这些特殊字符：< > & ‘ ” / \ 以及TAB、换行、回车键。

请求通用参数

1、每个请求接口中的均需传入以下通用参数，详细定义如下表所示：

名称	类型	描述
access_token 必填	string	授权令牌，完成 OAuth 2.0 授权后获得，参考Oauth2.0授权-授权流程章节。 以Query Parameter方式在请求路径中传递。
timestamp 必填	timestamp	当前的时间戳，单位为毫秒，允许客户端请求最大时间误差为600秒。MarketingAPI 所使用的时间戳，若无特殊说明，均为毫秒级时间戳。MarketingAPI 所使用的时区为GMT+8，例如当时间戳为1598451101338时，表示 2020-08-26 22:11:41 以Query Parameter方式在请求路径中传递。
nonce 必填	string	随机字串标识，不超过32个字符，由调用方自行生成，需保证全局唯一性。 以Query Parameter方式在请求路径中传递。
advertiser_id	String	账户ID。 如果授权帐号是二代账户，需要填写要操作的对应投放账户id（可通过查询二代下属广告主接口获取，取UUID字段）； 如果授权账户是广告主投放账户则可以不填； 以Query Parameter方式在请求路径中传递。

---