玉米广告文档中心

404 Not Found

nginx

1、接入说明

1.1 接入条件

确保账号审核通过。

需要相关的开发者id和密钥，请联系商务合作经理获取。

1.2 接口风格

采用restfull api风格

以http状态码来表明请求资源的状态

1.3 接口限制

采用签名验证的方式来验证权限

验证通过后, 同一资源每天最多可请求100次

1.4 接口的验证

开发者审核通过后,请求接口需要带三个参数

参数

描述

signature

加密签名，signature结合了开发者的密钥参数和请求中的timestamp参数、 nonce参数。

timestamp

时间戳

nonce

随机数

加密/校验流程如下：

1.将token、timestamp、nonce三个参数进行字典序排序

2.将三个参数字符串拼接成一个字符串进行sha1加密

3.开发者获得加密后的字符串可与signature对比，标识该请求合法

检验signature的PHP示例代码：

private function checkSignature()
{
  $signature = $_GET["signature"];
  $timestamp = $_GET["timestamp"];
  $nonce = $_GET["nonce"];  

  $token = TOKEN;
  $tmpArr = array($token, $timestamp, $nonce);
  sort($tmpArr, SORT_STRING);
  $tmpStr = implode( $tmpArr );
  $tmpStr = sha1( $tmpStr );

  if ($tmpStr == $signature) {
    return true;
  } else {
    return false;
  }
}

1.5 响应的数据格式

数据格式为json

字段说明

error 错误信息,当请求有误时的提示文字

data 数据相关信息

1.6 http状态码常见业务释义

http 状态码

释义

200

获取成功

400

请求参数有误,请检查参数

401

用户验证有误,请检查验证信息

403

禁止访问,有可能超出了请求次数限制

2、应用列表接口

2.1 描述

获取开发者的有效应用列表

2.2 接口信息

url

method

说明

developer/{devId}/app/index

GET

devId 为开发者id

2.3 请求信息

字段

数据类型

说明

{devId}

string

位于url中，为开发者id

2.4 响应

示例:

{
  error: "",
  data: [
    {
      cornid: "testtest10241024",
      appname: "你好",
      os: "ios",
      currency: "CNY"
    },
    ...
  ]
}

data字段说明:

名称

数据类型

说明

cornid

string

应用id

appname

string

应用名称

string

系统 android或ios

currency

结算货币类型

例如：CNY为人民币

3、应用统计接口

3.1 描述

获取开发者某应用的统计数据

3.2 接口信息

url

method

说明

developer/{devId}/app/{cornId}/stat

GET

devId 为开发者id cornId 为应用id

3.3 请求信息

字段

数据类型

说明

{devId}

string

位于url中，为开发者id

{cornId}

string

位于url中，为应用id

start_date

date

开始日期,必选参数,格式为2010-01-01,闭区间

end_date

date

结束日期,必选参数,格式为2010-01-01,闭区间

关于日期的相关说明：

1.当天下午16:30之后,可以获取到昨天的数据

2.时间范围不可以超过三十天

3.起始日期不可以在半年之前

3.4 响应

示例:

{
  error: "",
  data: [
    {
      date: "2016-08-02",
      ad_type: "interstitial",
      request: 21896,
      exposure: 19784,
      click: 5522,
      fill_rate: "90.35%",
      click_rate: "27.91%",
      ecpm: "16.45",
      income: "162.71"
    }
  ]
}

data字段说明:

名称

数据类型

说明

date

日期

ad_type

enum

应用广告形式 banner => 横幅,interstitial => 插屏,video => 视频,splash => 启动/开屏,native => 原生

request

int

请求数

exposure

int

展示数

click

int

点击数

fill_rate

string

填充率,保留小数点后两位,理论最大值为100.

click_rate

string

点击率,保留小数点后两位,理论最大值为100.

ecpm

string

ecpm,若为'-'则表示: 因网络延迟等特殊原因,尚未处理完成. 其余情况皆为float格式的字符串.

income

string

收益,若为'-'则表示: 因网络延迟等特殊原因,尚未处理完成. 其余情况皆为float格式的字符串.货币的类型与用户设置的货币类型一致.

404 Not Found

nginx