银联商务天满服务平台
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/getads";
        //开发者ID
        String appId = "平台分配";
        //开发者秘钥
        String appKey = "平台分配";
        //实例化客户端
        ConfigBean configBean = new ConfigBean();
        OpenApiContext context = new OpenApiContext();
        String request = "{\"channel\":\"\",
                    \"merchNo\":\"\",
                    \"tradeAmt\":\"\"}";
        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/getads";
        $data = json_encode(array("channel"=>"",
                    "merchNo"=>"",
                    "tradeAmt"=>""));
        $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/getads"

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\":\"\",
                    \"merchNo\":\"\",
                    \"tradeAmt\":\"\"})
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/getads

描述:具体商户的广告位内容由广告平台统一管理,广告投放平台支持广告主在指定商户、指定交易金额范围、指定地域、指定时间条件内进行投放。 支付页面调取广告平台指定接口(POST请求),带指定交易参数发送请求,广告平台返回图片链接及点击图片后跳转链接(JSON格式

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: E开票(发票详情页) 0301: E开票(开票成功页面)
merchNo string 15 设备号
tradeAmt string 2 单位 分

响应示例

{
  "adsInfoList":
  [
    {
      "id":"",
      "imgUrl":"",
      "imgLink":""
    } 
  ],
  "targetSys":"",
  "rspCode":"",
  "rspMsg":""
}

响应参数

名称 类型 必填 最大长度 描述 示例值
adsInfoList array 返回广告信息 为空表示无广告
   id string 64 广告id
   imgUrl string 64 图片链接
   imgLink string 64 点击图片跳转链接
targetSys string 64 目标系统 返回 ADS
rspCode string 64 返回码
rspMsg string 64 返回码描述

错误码