https://xxxxxx/v4/official_account_open_http_svc/add_subscriber?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Parameter | Description |
xxxxxx | The dedicated domain name corresponding to the country/region of the SDKAppID: China: console.tim.qq.com Singapore: adminapisgp.im.qcloud.com Seoul: adminapikr.im.qcloud.com Frankfurt: adminapiger.im.qcloud.com Silicon Valley: adminapiusa.im.qcloud.com Jakarta: adminapiidn.im.qcloud.com |
v4/official_account_open_http_svc/add_subscriber | Request API. |
sdkappid | The SDKAppID assigned by the Chat console when an application is created. |
identifier | |
usersig | |
random | A random 32-bit unsigned integer ranging from 0 to 4294967295. |
contenttype | The value is always json . |
{"Official_Account": "@TOA#_@TOA#dOEF", // The desired official account (required)"SubscriberList": [ // Up to 100 subscribers can be added at a time.{"Subscriber_Account": "107867" // UserID of the subscriber to be added},{"Subscriber_Account": "966582476"}]}
Field | Type | Required | Description |
Official_Account | String | Yes | ID of the official account to be subscribed to. Use the OfficialAccountUserID field returned by the API during creation. |
SubscriberList | Array | Yes | Array of subscribers to be added. |
Subscriber_Account | String | Yes | UserID of the subscriber to be added. |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"SubscriberList": [{"Subscriber_Account": "107867","Result": 2},{"Subscriber_Account": "966582476","Result": 1 // Addition result. 0: failed; 1: succeeded; 2: already subscribed.}]}
Field | Type | Description |
ActionStatus | String | Processing result: OK: succeeded. FAIL: failed. |
ErrorCode | Integer | Error code: 0: succeeded. Other values: failed. |
ErrorInfo | String | Error information. |
SubscriberList | Array | Returned results of added subscribers. |
Subscriber_Account | String | Returned subscriber UserID. |
Result | Integer | Addition result: 0: failed. 1: succeeded. 2: already followed this official account. |
Error Code | Description |
6017 | Invalid request parameter. Please modify and retry. |
10004 | Internal server error. Please try again. |
20001 | Invalid request packet. Please modify and retry. |
20005 | Internal server error. Please try again. |
130002 | Insufficient operation permissions. Please check the request parameters based on the error message. |
130004 | The official account user does not exist, or once existed but has now been terminated. |
130006 | The number of subscribers for this official account has reached its limit. Please refer to Pricing to purchase or upgrade related packages and expand the maximum number of subscribers for the official account. (After upgrading, you need to call the Modifying Official Account Information API to update the maximum number of subscribers supported.) |
130007 | Incorrect official account user ID. Please modify and retry. |
130008 | The official account user ID is already in use. |
131000 | This AppId has not been enabled with official account service. |
130010 | The number of official accounts a subscriber can join has exceeded the limit. Please check and unsubscribe from some official accounts. |
Was this page helpful?