Extended bit management interface

# Extended bit management interface

Interface Name	Introductions
Add promotion bit	Support alliance developers to add promotion bits via interface
Delete promotion bit	Support alliance developers to remove promotion bits via interface
Editorial Promotion Position	Support alliance developers to popularize bit names through interface editing
Get a list of promoted bits	Support alliance developers to get promoted bit list via interface

# 1. Add Promotion Spots

# Interface Dxplaination

Support alliance developer call interface add promotion bit

# Request address

POST https://api.weixin.qq.com/union/promoter/promotion/add?access_token=ACCESS_TOKEN

# Request parameters

attribute	type	Default values	Required	Introductions
access_token	string		yes	Interface calling credential
promotionSourceName	string		yes	Extended bit name (maximum 20 words, name not repeatable)

# POST sample

{
  "promotionSourceName": "Promotion Bit Name"
}

# Return value

# Object

Returned JSON Data packet

attribute	type	Introductions
Errcode	number	Error code
errmsg	string	Error message
pid	string	Generalized Bit ID, PID

# Return Example

{
    "errcode": 0,
    "errmsg": "ok",
    "pid": "oUkIc71zinc2mtlfC7K-NfGJxxNE_328751529"
}

# Error code

value	Introductions
14005	Maximum number of promotion places
14007	Extended bit name duplication

# 2. Delete Promotion Places

# Interface Dxplaination

Delete a promotion bit

# Request address

POST https://api.weixin.qq.com/union/promoter/promotion/of the?access_token=ACCESS_TOKEN

# Request parameters

attribute	type	Required	Introductions
access_token	string	yes	Interface calling credential
promotionSourcePid	string	yes	Generalized bit PID
promotionSourceName	string	yes	Promotion bit name

# POST sample

{
  "promotionSourcePid": "oUnIc49z",
  "promotionSourceName": "Promotion Bit Name"
}

# Return value

# Object

Returned JSON Data packet

attribute	type	Introductions
Errcode	number	Error code
errmsg	string	Error message

# 3. Editorial outreach

# Interface Dxplaination

Modify the specified promoted bit name

# Request address

POST https://api.weixin.qq.com/union/promoter/promotion/upd?access_token=ACCESS_TOKEN

# Request parameters

attribute	type	Required	Introductions
access_token	string	yes	Interface calling credential
previousPromotionInfo	Object	yes
previousPromotionInfo.promotionSourcePid	string	yes	Generalized bit PID to modify
previousPromotionInfo.promotionSourceName	string	yes	Name before modification
promotionInfo	Object	yes
promotionInfo.promotionSourceName	string	yes	Name modified

# POST sample

{
  "previousPromotionInfo": {
    "promotionSourcePid": "oUnIc49z",
    "promotionSourceName": "delete"
  },
  "promotionInfo": {
    "promotionSourceName": "upd after22"
  }
}

# Return value

# Object

Returned JSON Data packet

attribute	type	Introductions
Errcode	number	Error code
errmsg	string	Error message

# Get a list of promoted bits

# Interface Dxplaination

Get a list of promoted bits

# Request address

GET https://api.weixin.qq.com/union/promoter/promotion/list?access_token=ACCESS_TOKEN

# Request parameters

attribute	type	Default values	Required	Introductions
access_token	string		yes	Interface calling credential
start	number	0	yes	deviation
limit	number	20	yes	Number of posts per page

# Return value

# Object

Returned JSON Data packet

attribute	type	Introductions
Errcode	number	Error code
errmsg	string	Error message
total	number	Total number of promotion places
promotionMaxCnt	number	Maximum number of promoted bits allowed
promotionSourceList	Array.&ltObject&gt	Promotion bit data

promotionSourceList Structure

attribute	type	Introductions
promotionSourceName	string	Promotion bit name
promotionSourcePid	string	Generalized Bit ID, PID

# Return Example

{
    "errcode": 0,
    "errmsg": "",
    "promotionSourceList": [
        {
            "promotionSourceName": "23444444444",
            "promotionSourcePid": "oqt8u5MV-nX9iyrzARrq-QFsxI28_648499549",
            "status": "1",
            'pidId': "3457"
        },
        {
            "promotionSourceName": "123",
            "promotionSourcePid": "oqt8u5MV-nX9iyrzARrq-QFsxI28_1515204302",
            "status": "1",
            'pidId': "3452"
        }
    ],
    "total": 91,
    "promotionMaxCnt": 100
}