製品の説明

製品の概要

Basic Concepts

ユースケース

機能概要

アカウントシステム

ユーザープロフィールとリレーションシップチェーン

メッセージ管理

グループシステム

Official Account

Audio/Video Call

使用制限

購入ガイド

課金概要

価格説明

Purchase Instructions

Renewal Guide

支払い延滞説明

Refund Policy

ダウンロードセンター

SDK & Demo ソースコード

更新ログ

シナリオプラン

Live Streaming Setup Guide

AI Chatbot

極めて大規模なエンターテインメントコラボレーションコミュニティ

Discord実装ガイド

ゲーム内IM統合ガイド

WhatsApp Channel-style Official Account Integration Solution

Send Red Packet

Firewall Restrictions

クライアントAPIs

SDK API（Web）

Android

iOS & macOS

Swift

Flutter

SDK API（Electron）

SDK APIs (Unity)

SDK API（React Native）

C APIs

C++

サービス側 APIs

UserSigの生成

RESTful APIs

Webhooks

コンソールガイド

New Console Introduction

アプリケーションの作成とアップグレード

基本設定

機能設定

アカウント管理

グループ管理

Official Channel Management

コールバック設定

監視ダッシュボード

Viewing Guide for Resource Packages

Real-Time Monitor

補助ツールの開発

アクセス管理

Advanced Features

よくあるご質問

uni-app FAQs

購入に関する質問

SDKに関する質問

アカウント認証に関する質問

ユーザープロファイルとリレーションシップチェーンに関する質問

メッセージに関する質問

グループに関する質問

ライブ配信グループに関する質問

ニックネームプロフィール画像に関連した問題

一般的なリファレンス

Service Level Agreement

セキュリティコンプライアンス認証

IM ポリシー

プライバシーポリシー

データプライバシーとセキュリティ契約

エラーコード

お問い合わせ

Pulling Lists

PDF

フォーカスモード

フォントサイズ

最終更新日: 2024-09-25 15:13:30

Feature Description
This API is used to pull friend lists. You can specify the lists to pull and pull the friends in the lists.
API Calling Description
Sample request URL
﻿
https://xxxxxx/v4/sns/group_get?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
﻿
Request parameters
The following table only describes the modified parameters when this API is called. For more information on other parameters, please see RESTful API Overview.
Parameter
Description
https
The request protocol is HTTPS, and the request method is POST.
xxxxxx
The country/region where your SDKAppID is located.
China:  console.tim.qq.com
Singapore:  adminapisgp.im.qcloud.com
Seoul: adminapikr.im.qcloud.com
Frankfurt: adminapiger.im.qcloud.com
India: adminapiind.im.qcloud.com
Silicon Valley: adminapiusa.im.qcloud.com
Jakarta: adminapiidn.im.qcloud.com
v4/sns/group_get
Request API
sdkappid
SDKAppID assigned by the IM console when an app is created
identifier
App admin account. For more information, please see the App Admin section in Login Authentication.
usersig
Signature generated in the app admin account. For details on how to generate the signature, please see Generating UserSig.
random
A random 32-bit unsigned integer ranging from 0 to 4294967295
contenttype
Request format. The value is always json.
Maximum calling frequency
200 calls per second
Sample request packets
Basic request
﻿
{
"From_Account":"id"
}
﻿
Complete request
﻿
{
﻿
     "From_Account":"id", 
﻿
     "NeedFriend":"Need_Friend_Type_Yes", 
﻿
      "GroupName": [
﻿
     "group1"
﻿
     ]
﻿
}
﻿
﻿
Request packet fields
Field
Type
Required
Description
From_Account
String
Yes
UserID of the account for which to pull friend lists
NeedFriend
String
No
Whether to pull the users in the list. Need_Friend_Type_Yes: pulls users. If this field is left empty, users will not be pulled. It is valid only when GroupName is left empty.
GroupName
Array
No
Name of the list to pull
Sample response packets
Response to a basic request
﻿
{
﻿
  "ResultItem": [
﻿
      {
﻿
          "GroupName": "group1",
﻿
          "FriendNumber": 1
﻿
      },
﻿
      {
﻿
          "GroupName": "group2",
﻿
          "FriendNumber": 2
﻿
      },
﻿
      {
﻿
          "GroupName": "group3",
﻿
          "FriendNumber": 3
﻿
      }
﻿
  ],
﻿
  "CurrentSequence": 2,
﻿
  "ActionStatus": "OK",
﻿
  "ErrorCode": 0,
﻿
  "ErrorInfo": "",
﻿
  "ErrorDisplay": ""
﻿
}
﻿
Response to a complete request
﻿
{
﻿
  "ResultItem": [
﻿
      {
﻿
          "GroupName": "group1",
﻿
          "FriendNumber": 1,
﻿
          "To_Account": ["friend1"]
﻿
      }  
﻿
  ],
﻿
  "CurrentSequence": 2,
﻿
  "ActionStatus": "OK",
﻿
  "ErrorCode": 0,
﻿
  "ErrorInfo": "",
﻿
  "ErrorDisplay": ""
﻿
}
﻿
Response packet fields
Field
Type
Description
ResultItem
Array
Result object array of pulling lists
GroupName
String
List name
FriendNumber
Integer
Number of friends in the list
To_Account
Array
UserID of friends in the list
CurrentSequence
Integer
Current sequence of the lists
ActionStatus
String
Request result. OK: successful; FAIL: failed
ErrorCode
Integer
Error code. 0: successful; other values: failed. For details on non-zero results, see Error Codes.
ErrorInfo
String
Detailed error information
ErrorDisplay
String
Detailed information displayed on the client
﻿
Error Codes
The returned HTTP status code for this API is always 200 unless a network error (such as error 502) occurs. The specific error code and details can be found in the response fields ResultCode, ResultInfo, ErrorCode, and ErrorInfo.
For public error codes (60000 to 79999), please see Error Codes.
The following table describes the error codes specific to this API:
Error Code
Description
30001
Incorrect request parameter. Check your request according to the error description.
30003
The requested account does not exist.
30004
The request requires app admin permissions.
30006
Internal server error. Try again.
30007
Network timeout. Try again later.
API Debugging Tool
Use the RESTful API online debugging tool to debug this API.
References
﻿Adding Lists 
﻿Deleting Lists 

ヘルプとサポート

この記事はお役に立ちましたか？

営業担当者にお問い合わせいただくかチケットを提出してサポートを求めることができます。

フィードバック

Parameter	Description
https	The request protocol is HTTPS, and the request method is POST.
xxxxxx	The country/region where your SDKAppID is located. China: `console.tim.qq.com` Singapore: `adminapisgp.im.qcloud.com` Seoul: `adminapikr.im.qcloud.com` Frankfurt: `adminapiger.im.qcloud.com` India: `adminapiind.im.qcloud.com` Silicon Valley: `adminapiusa.im.qcloud.com` Jakarta: `adminapiidn.im.qcloud.com`
v4/sns/group_get	Request API
sdkappid	`SDKAppID` assigned by the IM console when an app is created
identifier	App admin account. For more information, please see the App Admin section in Login Authentication.
usersig	Signature generated in the app admin account. For details on how to generate the signature, please see Generating UserSig.
random	A random 32-bit unsigned integer ranging from 0 to 4294967295
contenttype	Request format. The value is always `json`.

Field	Type	Required	Description
From_Account	String	Yes	`UserID` of the account for which to pull friend lists
NeedFriend	String	No	Whether to pull the users in the list. `Need_Friend_Type_Yes`: pulls users. If this field is left empty, users will not be pulled. It is valid only when `GroupName` is left empty.
GroupName	Array	No	Name of the list to pull

Error Code	Description
30001	Incorrect request parameter. Check your request according to the error description.
30003	The requested account does not exist.
30004	The request requires app admin permissions.
30006	Internal server error. Try again.
30007	Network timeout. Try again later.

tencent cloud

Chat

Pulling Lists

Feature Description

API Calling Description

Sample request URL

Request parameters

Maximum calling frequency

Sample request packets

Request packet fields

Sample response packets

Response packet fields

Error Codes

API Debugging Tool

References

ヘルプとサポート