SDK对外接口
  1. 天级数据
SDK对外接口
  • 天级数据
    • 天级数据V1
      GET
  1. 天级数据

天级数据V1

测试环境
https://jhdemo.cloooud.com/base
测试环境
https://jhdemo.cloooud.com/base
GET
/api/v1/report/day

地址：#

测试环境： https://jhdemo.cloooud.com/base/api/v1/report/day
正式环境： https://manage.cloooud.com/base/api/v1/report/day

签名示例：#

媒体ID： media_id = 1
秘钥： secret = "e22a938a6f16de9e9d89d635c72177e7" （「后台-媒体管理-详情」 中可查看）
1.
如以下提交参数：
start_date="20250101"
end_date="20250201"
media_id="1"
os=""
app_id=""
slot_id=""
fields="app_id"
page="2"
page_size="3"
timestamp="1742800440"
2.
对提交params参数按key正序排序后，组装成k=v&k1=v1的待加密字符串(提交的所有key均参与拼接)：
app_id=&end_date=20250201&fields=app_id&media_id=1&os=&page=2&page_size=3&slot_id=&start_date=20250101&timestamp=1742800440
3.
拼接秘钥（=待加密字符串+秘钥）：
// 待加密字符串
app_id=&end_date=20250201&fields=app_id&media_id=1&os=&page=2&page_size=3&slot_id=&start_date=20250101&timestamp=1742800440e22a938a6f16de9e9d89d635c72177e7
4.
MD5加密：
// MD5加密
sign = MD5("app_id=&end_date=20250201&fields=app_id&media_id=1&os=&page=2&page_size=3&slot_id=&start_date=20250101&timestamp=1742800440e22a938a6f16de9e9d89d635c72177e7")
// 得到
sign = 0ba87d8626398f4630ee5d52c783bb4b

请求参数

Query 参数
start_date
string 
必需
开始日期，格式YYYYmmdd
示例值:
20250203
end_date
string 
必需
结束日期，格式YYYYmmdd（最大间隔1月，含当天）
示例值:
20250203
media_id
string 
媒体ID
必需
示例值:
52600
os
string 
可选
操作系统，多个”,“拼接。1:安卓、2:iOS
示例值:
1
app_id
string 
可选
应用ID，多个”,“拼接
slot_id
string 
可选
广告位ID，多个”,“拼接
slot_type
string 
可选
广告位类型，多个”,“拼接。1:"开屏"、2:"插屏"、3:"banner"、4:"信息流"、5:"激励视频"
fields
string 
可选
数据维度字段，多个”,“拼接，默认：“os,app_id,slot_id,slot_type”（注：未选择字段值为空）。os:系统平台、app_id:应用、slot_id:广告位、slot_type:广告位类型
示例值:
os,app_id,slot_id,slot_type
page
string 
默认1
可选
示例值:
1
page_size
string 
可选
默认1000，最大5000
示例值:
1000
timestamp
string 
必需
当前时间戳（秒）。注：请求时差不超过5分钟
示例值:
1742871935
Header 参数
Sign
string 
签名字符串
必需
示例值:
0ba87d8626398f4630ee5d52c783bb4b

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://jhdemo.cloooud.com/base/api/v1/report/day?start_date=20250203&end_date=20250203&media_id=52600&os=1&app_id=&slot_id=&slot_type&fields=os,app_id,slot_id,slot_type&page=1&page_size=1000&timestamp=1742871935' \
--header 'Sign: 0ba87d8626398f4630ee5d52c783bb4b'

返回响应

🟢200成功
application/json
Body
code
integer 
1：成功，0：失败
必需
message
string 
必需
data
object 
必需
list
array [object {16}] 
必需
total
integer 
总条数
必需
has_next
boolean 
是否存在下一页
必需
示例
{
    "code": 1,
    "message": "操作成功",
    "data": {
        "has_next": true,
        "list": [
            {
                "date": "20250103",
                "app_id": 767930,
                "app_name": "可可可可",
                "slot_id": 0,
                "slot_name": "",
                "os": 0,
                "os_name": "",
                "slot_type": 1,
                "slot_type_name": "开屏",
                "income": "50.00",
                "req": "4674",
                "resp": "4204",
                "rate": "89.94",
                "imp": "4000",
                "imp_rate": "100.00",
                "clk": "4000",
                "clk_Rate": "100.00",
                "ecpm": "12.50"
            }
        ],
        "total": 1
    }
}
Built with