发起请求

本节将为您介绍发起一次API请求的说明。

请求URL

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

正式环境为：https://openapi.aiclk.com/<version>/openapi/<对应uri>

说明： 当前版本为v1

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

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

X-Release-Date：用于指定使用当前接口的release日期，接口小版本的迭代会根据release日期有小的改动。

Content-Type: application/json

X-Release-Date: yyyy-MM-dd

请求时，需要在Header中添加： OGW_ACCESS_TOKEN 作为授权的判断

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

调用API需要遵循API系统本身的限制规则，我们针对API所有的接口都进行了一定程度的调用频次限制。我们针对每一个开发者应用都设置了四个不同等级的调用频次限制，包括了调用分钟限制、调用天限制（对于每一个应用的频率控制如果有需要，可以联系相关产品人员进行调整），具体规则如下：

概述：

类别	限制描述
调用分钟频次	1.系统针对每个开发者应用都有分钟调用频次，不同等级的应用调用频次限制不同。 2.达到当前分钟限制后，您当前分钟将无法继续调用超限的接口，下一分钟后自动恢复正常。
调用天频次	1.系统针对每个开发者应用都有天调用频次，不同等级的应用调用频次限制不同。 2.达到当天的限制后，您当日将无法继续调用超限的接口，第二个自然日可自动恢复正常。

频次通用限制规则