import com.chinaums.open.api.OpenApiCache;
import com.chinaums.open.api.OpenApiContext;
import com.chinaums.open.api.constants.ConfigBean;
import com.chinaums.open.api.internal.util.http.HttpTransport;
import java.util.UUID;
public class OpenApiSdkTest {
public static void main(String[] args) throws Exception{
String url = "/v1/media/advertisement/createads";
//开发者ID
String appId = "平台分配";
//开发者秘钥
String appKey = "平台分配";
//实例化客户端
ConfigBean configBean = new ConfigBean();
OpenApiContext context = new OpenApiContext();
String request = "{\"advType\":\"\",
\"advName\":\"\",
\"advArea\":\"\",
\"rangeComsume\":\"\",
\"startTime\":\"\",
\"endTime\":\"\",
\"bidPrice\":\"\",
\"volume\":\"\",
\"imgUrl\":\"\",
\"imgLink\":\"\",
\"dailyLimitCount\":\"\",
\"dailyLimitStartTime\":\"\",
\"dailyLimitEndTime\":\"\"}";
context.setStartTime(System.currentTimeMillis());
context.setRequestId(UUID.randomUUID().toString().replace("-", ""));
context.setOpenServUrl(url.split("/v")[0].concat("/"));
context.setApiServiceUrl(url);
context.setVersion(url.split("/")[3]);
context.setAppId(appId);
context.setAppKey(appKey);
context.setConfigBean(configBean);
context.setServiceCode(url.split("/v")[1].substring(1));
OpenApiCache.getCurrentToken(context);
System.out.println(HttpTransport.getInstance().doPost(context, request));
}
}
<?php
require_once "../utils/Log.php";
require_once "../utils/Tools.php";
require_once "../DefaultOpenApiClient.php";
class DataRequest
{
public $url = "";
public $serviceCode = "";
public $apiVersion ="";
public $needToken = true;
public $needDataTag = false;
public $data;
function __construct($data, $url)
{
$this->data = $data;
$apiVersion = preg_split("/[/]+/s",$url)[2];
$this->apiVersion = $apiVersion;
$serviceCode = strstr($url,$apiVersion);
$this->url = strstr($url,"/".$apiVersion,true);
$this->serviceCode = preg_replace("/^" . preg_quote($apiVersion, "/") . "/", "", $serviceCode);
}
}
class DataDemo{
public function main(){
$appid = "平台分配";
$appkey = "平台分配";
$url = "/v1/media/advertisement/createads";
$data = json_encode(array("advType"=>"",
"advName"=>"",
"advArea"=>"",
"rangeComsume"=>"",
"startTime"=>"",
"endTime"=>"",
"bidPrice"=>"",
"volume"=>"",
"imgUrl"=>"",
"imgLink"=>"",
"dailyLimitCount"=>"",
"dailyLimitStartTime"=>"",
"dailyLimitEndTime"=>""));
$reqiest = new DataRequest($data,$url);
$client = new DefaultOpenApiClient();
$content = $client->execute($reqiest,$appid,$appkey);
$obj = json_decode($content);
print_r($obj->errCode);
print_r($obj->errInfo);
}
}
$p = new DataDemo();
$p->main();
?>
# -*- coding: utf-8 -*-
from webapi.DefaultOpenApiClient import DefaultOpenApiClient
url = "/v1/media/advertisement/createads"
class DataRequest(object):
def __init__(self, data: dict) -> dict:
self.data = data
self.serviceCode = url[len(url.split("/v")[0])+len(url.split("/")[3])+1: len(url)]
self.apiVersion = url.split("/")[3]
self.needToken = True
self.needDataTag = True
appId="平台分配"
appKey="平台分配"
client = DefaultOpenApiClient(appId, appKey)
cls = DataRequest({\"advType\":\"\",
\"advName\":\"\",
\"advArea\":\"\",
\"rangeComsume\":\"\",
\"startTime\":\"\",
\"endTime\":\"\",
\"bidPrice\":\"\",
\"volume\":\"\",
\"imgUrl\":\"\",
\"imgLink\":\"\",
\"dailyLimitCount\":\"\",
\"dailyLimitStartTime\":\"\",
\"dailyLimitEndTime\":\"\"})
response = client.execute(cls)
print(str(response.get("data")))
print(response.get("errCode"))
print(response.get("errInfo"))
print(response.get("resultCode"))
print(response.get("resultInfo"))
广告创建
URL
- 生产环境:
POST
https://api-mop.chinaums.com/v1/media/advertisement/createads
描述:通过该接口创建广告, 广告创建成功后,需广告广告平台运营人员审核生效后才会进行投放,可通过广告状态查询查询广告状态
ContentType:application/json
请求头
名称 | 必填 | 描述 | 示例值 |
---|---|---|---|
Authorization | 是 | 认证内容 | OPEN-BODY-SIG AppId="****",Timestamp="20170606135700",Nonce="99930a147f5353dd8a8f29a5329f37e9",Signature="IPmdGHYCcfN+mto0/02zkwoUF1NT3YqPKaUykMaec1T=" |
请求参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
advType | string | 是 | 2 | 01--签购单广告 02--移动支付广告 | |
advName | string | 是 | 200 | 广告说明 | |
advArea | string | 否 | 32 | 投放地区 | |
rangeComsume | string | 否 | 32 | 消费金额区间, 单位元,格式为x-y , 0<=x<y, x、y为整数。如如0-100 | |
startTime | string | 是 | 10 | 投放开始时间 | |
endTime | string | 是 | 10 | 投放结束时间 | |
bidPrice | string | 是 | 12 | 千展单价 单位 元, 正整数 | |
volume | string | 是 | 12 | 投放量 单位 千次,正整数 | |
imgUrl | string | 是 | 200 | 广告尺寸为230*690像素 | |
imgLink | string | 是 | 200 | 点击图片后跳转链接 | |
dailyLimitCount | string | 否 | 10 | 单位 千次,正整数。日限额非空,日限额开始/结束日期也需要填 | |
dailyLimitStartTime | string | 否 | 格式 yyyyMMdd >=开始日期限额 | ||
dailyLimitEndTime | string | 否 | 格式 yyyyMMdd。 <结束日期限额 |
响应示例
{
"targetSys":"",
"rspCode":"",
"rspMsg":"",
"advId":""
}
响应参数
名称 | 类型 | 必填 | 最大长度 | 描述 | 示例值 |
---|---|---|---|---|---|
targetSys | string | 是 | 64 | 目标系统 | |
rspCode | string | 是 | 64 | 返回码 | |
rspMsg | string | 是 | 64 | 字符串 | |
advId | string | 是 | 64 | 创建成功返回广告ID |