OkayAPI Docs
API Params
| Parameter | Type | Required | Default | Note | Description |
|---|---|---|---|---|---|
| HTTP_APPKEY | String | Required | MIN: 32 | Common Put Your APPKEY | |
| AdUserIMEI | String | Optaion | 用户编号IMEI | ||
| OS | Int | Optaion | 安卓：0 IOS：1 其他：3 | ||
| MODEL | String | Optaion | 手机型号 | ||
| IP | String | Optaion | IP（192.168.100.100） | ||
| AID | String | Optaion | 广告计划id | ||
| CAMPAIGN_NAME | String | Optaion | 广告组名称 | ||
| AID_NAME | String | Optaion | 广告计划名称 | ||
| CID_NAME | String | Optaion | 广告创意名称 | ||
| IDFA | String | Optaion | IDFA | ||
| ANDROIDID | String | Optaion | ANDROIDID | ||
| oaid | String | Optaion | oaid | ||
| oaid_md5 | String | Optaion | __OAID_MD5__ | ||
| ts | String | Optaion | ts | ||
| callback | String | Optaion | __CALLBACK_URL__ | ||
| MAC1 | String | Optaion | 移动设备 mac 地址,转换成大写字母,并且取md5摘要后的结果，32位 | ||
| CAID1 | String | Optaion | 不同版本的中国广告协会互联网广告标识，CAID1是20201230版，暂无CAID2 | ||
| sourcename | String | Optaion | 来源 | ||
| tab | String | Optaion | 0 | 未知：0 装修：1 其他：3 | |
| AdUserPhone | String | Optaion | 用户手机号 | ||
| UA | String | Optaion | 用户代理(User Agent) | ||
| GEO | String | Optaion | 位置信息，包含三部分:纬度，经度以及确切信息,精度 | ||
| MAC | String | Optaion | 移动设备mac地址,转换成大写字母,去掉“:”，并且取md5摘要后的结果 | ||
| CONVERT_ID | String | Required | 转化id |
API Debug
| KEY | REQUIRED | VALUE |
|---|---|---|
| app_key | *Required | |
| AdUserIMEI | Option | |
| OS | Option | |
| MODEL | Option | |
| IP | Option | |
| AID | Option | |
| CAMPAIGN_NAME | Option | |
| AID_NAME | Option | |
| CID_NAME | Option | |
| IDFA | Option | |
| ANDROIDID | Option | |
| oaid | Option | |
| oaid_md5 | Option | |
| ts | Option | |
| callback | Option | |
| MAC1 | Option | |
| CAID1 | Option | |
| sourcename | Option | |
| tab | Option | |
| AdUserPhone | Option | |
| UA | Option | |
| GEO | Option | |
| MAC | Option | |
| CONVERT_ID | *Required |
API Response
| KEY | Type | Description |
|---|---|---|
| int | String | 新增数据的ID |
HTTP Response Code
| HTTP Status Code | Description |
|---|---|
| Http Status = 200 | Success |
| Http Status = 400 | 非法请求，参数错误 |
| Http Status = 401 | 用户未登录，或登录凭证已过期 |
| Http Status = 402 | IP已被黑名单拦截 |
| Http Status = 403 | IP未命中白名单 |
| Http Status = 404 | 接口服务不存在 |
| Http Status = 406 | 非法app_key，请核对你所在的接口域名 |
| Http Status = 407 | 当前应用已过期 |
| Http Status = 408 | 当前应用存在异常，已被封号 |
| Http Status = 409 | 签名错误 |
| Http Status = 410 | 权限不足，非系统管理员 |
| Http Status = 411 | 权限不足，应用管理员未登录 |
| Http Status = 412 | 权限不足，非应用管理员 |
| Http Status = 413 | 本月接口流量超出，已被临时冻结 |
| Http Status = 414 | 并发过高 |
| Http Status = 415 | 接口已被开发者关闭 |
| Http Status = 416 | 权限不足，个人免费版套餐无法使用专业版接口 |
| Http Status = 417 | 子应用异常，如：子应用签名错误/已过期/流量不足 |
| Http Status = 500 | 如果出现此错误，请联系技术人员处理 |