跳转至

新增广告主

新增广告主接口

请求地址

https://openapi.aiclk.com/openapi/v1/adaccount/customer/create

所属权限

ads_write

请求方式

POST

请求参数

字段名 类型 是否必须 描述
account_id int 代理商/子管理ID

Post body(json)

json体是一个列表结构,列表中的每一个元素结构如下:

字段名 类型 是否必须 描述
sub_agent_id uint64 子代理ID,调用者账号为代理商时可填
company string 广告主公司名称
display_name string 广告主公司简称
license_code string 营业执照统一社会信用代码
company_region []uint64 公司地址省市区编码,枚举值
company_address string 公司地址
license uint64 营业执照资源id,资源上传接口文档
qualification []uint64 资质证明资源id,资源上传接口文档
category int32 归属行业,对应最小粒度分类的ID,枚举值
app_name string 推广产品
username string 账户名称
password string 账户密码,必须包含大小写字母和数字,6到30位
link string 开户链接
source_mark string 广告主来源标识
app_company string 软著著作权人,当行业为应用下载时必填
privacy_protocol_url string 隐私政策协议,当行业为应用下载时必填
app_info string 应用介绍,当行业为应用下载时必填
app_permission string 应用权限,当行业为应用下载时必填
email string 公司邮箱
contacter string 联系人姓名
contacter_phone string 联系人电话
contacter_email string 联系人邮箱

Body 示例

{
  "sub_agent_id":1716318,
  "company": "测试公司",
  "display_name": "测试公司简称",
  "license_code": "DSSSAAASSSSWSSSSDA",
  "company_address":"上海上海市浦东新区三林软件园1号楼",
  "company_region":[310000,310100,310115],
  "license": 14705564,
  "qualification": [
    14705564
  ],
  "category": 100101101,
  "app_name": "测试产品名称",
  "username": "ceshizhanghumingcheng6",
  "password": "******",
  "link": "https://apps.apple.com/cn/app/affinity-photo-2-image-editor/id1616822987?mt=12",
  "source_mark": "来源标识",
  "app_company": "著作权人",
  "privacy_protocol_url": "https://quda.qutoutiao.net/pub/prd/aByL.html?t=1603353547893",
  "app_info": "应用介绍",
  "app_permission": "应用权限",
  "crowd_consumption_preference": 0,
  "email": "ceshiyouxiang@admin.com",
  "contacter": "联系人姓名",
  "contacter_phone": "17600000001",
  "contacter_email": "lianxiren@admin.com"
}

请求示例

curl --location 'https://openapi.aiclk.com/openapi/v1/adaccount/customer/create?account_id=1000003' \
--header 'Content-Type: application/json' \
--header 'OGW_ACCESS_TOKEN: your_access_token' \
--data-raw '{
    "sub_agent_id":1716318,
    "company": "测试公司",
    "display_name": "测试公司简称",
    "license_code": "DSSSAAASSSSWSSSSDA",
   "company_address":"上海上海市浦东新区三林软件园8号楼2楼",
   "company_region":[310000,310100,310115],
    "license": 14705564,
    "qualification": [
        14705564
    ],
    "category": 100101101,
    "app_name": "测试产品名称",
    "username": "ceshizhanghumingcheng7",
    "password": "Abc123",
    "link": "https://apps.apple.com/cn/app/affinity-photo-2-image-editor/id1616822987?mt=12",
    "source_mark": "来源标识",
    "app_company": "著作权人",
    "privacy_protocol_url": "https://quda.qutoutiao.net/pub/prd/aByL.html?t=1603353547893",
    "app_info": "应用介绍",
    "app_permission": "应用权限",
    "crowd_consumption_preference": 0,
    "email": "ceshiyouxiang@admin.com",
    "contacter": "联系人姓名",
    "contacter_phone": "17600000001",
    "contacter_email": "lianxiren@admin.com"
}'

返回字段释义

字段名 类型 描述
code int 返回码
message string 接口信息
data object 返回值
- account_id int 广告主ID
trace_id string trace ID

返回示例

{
  "code": 200,
  "data": {
    "account_id": 1928316
  },
  "message": "success",
  "trace_id": "56161c89ed743bff"
}