银联商务天满服务平台
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/createcloudads";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"channel\":\"\",
                    \"advName\":\"\",
                    \"startTime\":\"\",
                    \"endTime\":\"\",
                    \"bidPrice\":\"\",
                    \"volume\":\"\",
                    \"imgUrl\":\"\",
                    \"imgLink\":\"\",
                    \"dailyLimitCount\":\"\",
                    \"dailyLimitStartTime\":\"\",
                    \"dailyLimitEndTime\":\"\",
                    \"qulify_id\":\"\"}";
        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/createcloudads";
        $data = json_encode(array("channel"=>"",
                    "advName"=>"",
                    "startTime"=>"",
                    "endTime"=>"",
                    "bidPrice"=>"",
                    "volume"=>"",
                    "imgUrl"=>"",
                    "imgLink"=>"",
                    "dailyLimitCount"=>"",
                    "dailyLimitStartTime"=>"",
                    "dailyLimitEndTime"=>"",
                    "qulify_id"=>""));
        $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/createcloudads"

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({\"channel\":\"\",
                    \"advName\":\"\",
                    \"startTime\":\"\",
                    \"endTime\":\"\",
                    \"bidPrice\":\"\",
                    \"volume\":\"\",
                    \"imgUrl\":\"\",
                    \"imgLink\":\"\",
                    \"dailyLimitCount\":\"\",
                    \"dailyLimitStartTime\":\"\",
                    \"dailyLimitEndTime\":\"\",
                    \"qulify_id\":\"\"})
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/createcloudads

描述:通过该接口创建银商APP广告及其它类型云广告, 广告创建成功后,需广告广告平台运营人员审核生效后才会进行投放,可通过广告状态查询查询广告状态

ContentType:application/json

请求头

名称 必填 描述 示例值
Authorization 认证内容 OPEN-BODY-SIG AppId="****",Timestamp="20170606135700",Nonce="99930a147f5353dd8a8f29a5329f37e9",Signature="IPmdGHYCcfN+mto0/02zkwoUF1NT3YqPKaUykMaec1T="

请求参数

名称 类型 必填 最大长度 描述 示例值
channel string 6 0000: 银商APP开机屏 0001: 银商appbanner 0100: 江苏停车场 0200: 银行支付页 0300:开发票广告(详情页面) 0301: 开发票广告(成功页面) 0400:园区卡广告
advName string 200 广告说明
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 -
qulify_id string - 资质ID。需先通过接口创建资质

响应示例

{
  "advId":"",
  "targetSys":"",
  "rspCode":"",
  "rspMsg":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
advId string 64 创建成功返回广告ID
targetSys string 64 目标系统
rspCode string 64 返回码
rspMsg string 64 返回码描述

错误码