如需在线调试，请点击右上角全屏调试。

创建推广位

POST

/gateway/jd.union.open.position.create

工具商媒体帮助推客批量创建推广位，推广位分为两种类型：3：私域推广位，上限5000个，不在联盟后台展示，无对应 PID；4：联盟后台推广位，上限500个，在联盟后台展示，自动生成PID，可用于内容平台推广。业务参数key需要由推客进入联盟官网-我的工具-我的API中查询，有效期365天

请求参数

Body 参数application/json

unionId

string

联盟Id

必需

key

string

授权key

必需

unionType

string

推广位类型

必需

3：私域推广位，上限5000个，不在联盟后台展示，无对应 PID；4：联盟后台推广位，上限500个，会在推客联盟后台展示，自动生成对应PID，可用于内容平台推广

type

string

站点类型

必需

1.网站推广位2.APP推广位3.导购媒体推广位4.聊天工具推广位

spaceNameList

array[string]

推广位名称集合

必需

上限50

siteId

string | null

站点Id

可选

网站的ID/app ID/snsID 。当type非4(聊天工具)时，siteId必填

示例

{
  "unionId": "2014274090",
  "key": "fddc9a445f2de0df0f8acbce1ea16554ac4f5b7f4d3ab43b2197ac84eb24cd1eab608507c2a71244",
  "unionType": 4,
  "type": 4,
  "spaceName": "111测试122211211111"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://union.lottefuture.com/gateway/jd.union.open.position.create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "unionId": "2014274090",
    "key": "fddc9a445f2de0df0f8acbce1ea16554ac4f5b7f4d3ab43b2197ac84eb24cd1eab608507c2a71244",
    "unionType": 4,
    "type": 4,
    "spaceName": "111测试122211211111"
}'

返回响应

🟢200成功

application/json

Body

array of:

name

string

推广位名称

必需

positionId

integer

推广位Id

必需

pid

string

推广位PID

可选

pid结果，仅uniontype传4时，展示pid；可用于内容平台推广

示例

[
  {
    "name": "测试3333",
    "positionId": 3100167808,
    "pid": "2014274090_4100855912_3100167808"
  }
]

修改于 2023-07-17 08:19:58

工具商获取推广链接

查询推广位