银联商务天满服务平台
Java PHP Python



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

错误码