tencent cloud

Chat

製品の説明
製品の概要
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 ポリシー
プライバシーポリシー
データプライバシーとセキュリティ契約
エラーコード
お問い合わせ
ドキュメントChatサービス側 APIsWebhooksGroup Webhooksグループ作成前のコールバック

グループ作成前のコールバック

PDF
フォーカスモード
フォントサイズ
最終更新日: 2024-04-11 17:18:37

機能説明

Appバックグラウンドは、このコールバックを使用して、ユーザーのグループを作成するリクエストをバックグラウンドで拒否できるなど、ユーザーのグループを作成するリクエストをリアルタイムで確認できます。

注意事項

コールバックを有効にするには、コールバックURLを構成し、このコールバックプロトコルに対応するスイッチをオンにする必要があります。構成方法の詳細については、サードパーティのコールバック構成ドキュメントをご参照ください。
コールバックの方向は、IMバックグラウンドからAppバックグラウンドへのHTTP POSTリクエストを開始することです。
Appバックグラウンドは、コールバックリクエストを受け取った後、リクエストURLのパラメータSDKAppIDが独自のSDKAppIDであるかどうかを確認する必要があります。
その他のセキュリティ関連事項については、サードパーティコールバック概要：セキュリティに関する考慮事項ドキュメントをご参照ください。

コールバックをトリガーするシナリオ

Appユーザーは、クライアントを通じてグループを作成します
App管理者は、REST APIを通じてグループを作成します

コールバックの発生時間

IMバックグラウンドでグループを作成する準備が整う前。

インターフェースの説明

リクエストURLの事例

次の事例のApp構成のコールバックURLはhttps://www.example.comです。 事例：
https://www.example.com?SdkAppid=$SDKAppID&CallbackCommand=$CallbackCommand&contenttype=json&ClientIP=$ClientIP&OptPlatform=$OptPlatform

リクエストパラメータの説明

パラメータ
説明
https
リクエストプロトコルはHTTPS、リクエスト方式はPOSTです
www.example.com
コールバックURL
SdkAppid
アプリケーション作成時にIMコンソールで割り当てられたSDKAppID
CallbackCommand
Group.CallbackBeforeCreateGroupに固定します
contenttype
固定値はJSONです
ClientIP
クライアントIP、形式はたとえば127.0.0.1です
OptPlatform
クライアントプラットフォーム、値の選択は、サードパーティコールバック概要：コールバックプロトコルのパラメータOptPlatformの意味を参照します

リクエストパッケージの事例

{
    "CallbackCommand": "Group.CallbackBeforeCreateGroup", // コールバックコマンド
    "Operator_Account": "leckie", // オペレーター
    "Owner_Account": "leckie", // グループマスター
    "Type": "Public", // グループタイプ
    "Name": "MyFirstGroup", // グループ名
    "CreateGroupNum": 123, //このユーザーが作成した類似グループの数
    "MemberList": [ // 初期メンバーリスト
        {
            "Member_Account": "bob"
        },
        {
            "Member_Account": "peter"
        }
    ],
    "EventTime":"1670574414123"//ミリ秒レベル、イベントトリガーのタイムスタンプ
}

リクエストパッケージフィールドの説明

オブジェクト
概要
機能
CallbackCommand
String
コールバックコマンド
Operator_Account
String
グループ作成要求を開始したオペレーターUserID
Owner_Account
String
作成がリクエストされたグループのグループマスターUserID
Type
String
グループメッセージを生成するグループタイプ概要、たとえばPublic
Name
String
作成がリクエストされたグループ名
CreateGroupNum
Integer
このユーザーが作成した類似グループの数
MemberList
Array
作成がリクエストされたグループの初期化メンバーリスト
EventTime
Integer
イベントトリガーのミリ秒レベルのタイムスタンプ

レスポンスパッケージの事例

作成の許可

ユーザーがグループを作成することは許可されます。
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 0 // 作成は許可されます
}

作成の拒否

ユーザーがグループを作成することは許可されていません。グループは作成されず、呼び出し元にエラーコード10016が返されます。
{
    "ActionStatus": "OK",
    "ErrorInfo": "",
    "ErrorCode": 1 // 作成は拒否されます
}

レスポンスパッケージフィールドの説明

フィールド
タイプ
属性
説明
ActionStatus
String
必須
リクエスト処理の結果、OKは処理が成功したことを意味し、FAILは失敗を意味します
ErrorCode
Integer
必須
エラーコード。0は作成を許可、1は作成を拒否することを意味します。業務が独自のエラーコードを使用してユーザーのグループ作成を拒否したい場合は、エラーコードErrorCodeおよびErrorInfoをクライアントに渡します。エラーコードErrorCodeを[10100, 10200]の範囲内に設定してください
ErrorInfo
String
必須
エラーメッセージ

参考

サードパーティのコールバック概要
REST API：グループの作成
前の記事へ: Group Creation Daily Net Increase Threshold Alarm Callback次の記事へ: グループ作成後のコールバック

ヘルプとサポート

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

フィードバック