제품 개요
Basic Concepts
응용 시나리오
기능 소개
계정 시스템
사용자 정보 및 관계망
메시지 관리
그룹 시스템
Official Account
Audio/Video Call
사용 제한
https://xxxxxx/v4/official_account_open_http_svc/get_subscribed_official_account_list?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.comSingapore: adminapisgp.im.qcloud.comSeoul: adminapikr.im.qcloud.comTokyo: adminapijpn.im.qcloud.comFrankfurt: adminapiger.im.qcloud.comSilicon Valley: adminapiusa.im.qcloud.comJakarta: adminapiidn.im.qcloud.com |
v4/official_account_open_http_svc/get_subscribed_official_account_list | 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. |
{"Subscriber_Account": "107867", //Subscriber"Limit": 200,"Offset": 0,"ResponseFilter":{ //Filter fields"OfficialAccountBaseInfoFilter":[ //Filter fields for official channel information"CreateTime","Name","Owner_Account","LastMsgTime","SubscriberNum","Introduction","FaceUrl","Organization","CustomString"],"SelfInfoFilter":[ //Filter fields for subscriber information"SubscribeTime","CustomString"]}}
Field | Type | Required | Description |
Subscriber_Account | String | Yes | ID of the subscriber whose information is to be modified. |
Limit | Integer | No | Number of official channels pulled in a single pull, currently supporting a maximum value of 200. If not specified, the default is 200. |
Offset | Integer | No | Indicates starting pulling from which official channel. |
ResponseFilter | Object | No | Includes two filters: OfficialAccountBaseInfoFilter and SelfInfoFilter. OfficialAccountBaseInfoFilter: Indicates the basic information fields of official channels to be pulled, mainly including: CreateTime: creation time of the official channel Name: name of the official channel Owner_Account: user who owns the official channel LastMsgTime: time of the last message within the official channel SubscriberNum: current number of subscribers to the official channel Introduction: introduction to the official channel FaceUrl: avatar URL of the official channel Organization: organization of the official channel CustomString: custom field at the official channel level If not specified, all fields will be pulled. SelfInfoFilter: Indicates the need to pull subscriber's own information, mainly including: SubscribeTime: time when the subscriber subscribed to the official channel CustomString: custom field at the subscriber level If not specified, all fields will be pulled. |
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0,"TotalCount": 8, //The total number of subscribed official channels, unrelated to the pull limit"OfficialAccountInfoList": [ //List of official channels returned{"Name": "test_mill_subscriber_OA","Official_Account": "@TOA#_test_mill_subscriber_OA","Owner_Account": "107867","LastMsgTime": 1698894911,"SubscriberNum": 499800,"Introduction": "This is test Introduction","FaceUrl": "http://this.is.face.url","Organization": "Tencent","CustomString": "test_custom_string","SelfInfo": {"SubscribeTime": 1700655351,"CustomString": ""}//...There might be a lot more information to follow, but here information of only one official channel is displayed.],"CompleteFlag": 1, //Indicates whether the pull has ended. 1 means it has ended; 0 means it has not ended."Next": 0 //If the pull has ended, returns 0.}
Field | Type | Description |
ActionStatus | String | Processing result: OK: succeeded. FAIL: failed. |
ErrorCode | Integer | Error code: 0: succeeded. Other values: failed. |
ErrorInfo | String | Error information. |
OfficialAccountInfoList | Array | The official channel information obtained. The results are filtered information based on the filter fields set in the filter. |
TotalCount | Integer | Number of official channels subscribed by the user. |
CompleteFlag | Integer | Indicates whether the pull has ended. 1: The pull has ended. 0: The pull has not ended. |
Next | Integer | Indicates the next pull. If the current pull has not ended, it can be filled in the offset of the next pull as the offset for pagination. |
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 channel user does not exist, or once existed but has now been terminated. |
130007 | Incorrect official channel user ID. Please modify and retry. |
131000 | This AppId has not been enabled with official channel service. |
피드백