- 제품 소개
- 구매 가이드
- 다운로드 센터
- 시나리오 솔루션
- 클라이언트 APIs
- 서버 APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Message Related
- Session Related
- Group Related
- Group Management
- Group Information
- Group Member Management
- Group Member Information
- Group Custom Attributes
- Live Group Management
- Setting Live Streaming Group Robots
- Deleting Live Streaming Group Robots
- Setting/Deleting Live Streaming Group Administrators
- Obtaining the List of Live Streaming Group Administrators
- Checking Whether Users Are in a Live Streaming Group
- Getting the Number of Online Users in an Audio-Video Group
- Getting the List of Online Members in Audio-Video Group
- Setting Audio-Video Group Member Marks
- Getting the List of Banned Group Members
- Community Management
- Creating Topic
- Deleting Topic
- Getting Topic Profile
- Modifying Topic Profile
- Importing Topic Profiles
- Permission Group Management
- Creating Permission Groups
- Terminating Permission Groups
- Modifying Permission Group Information
- Obtaining Permission Group Information
- Adding Topic Permissions
- Modifying Topic Permissions
- Deleting Topic Permissions
- Obtaining Topic Permissions
- Adding Members to a Permission Group
- Deleting Permission Group Members
- Obtaining Permission Group Member List
- Getting the List of Online Members in Community Group
- Group Counter
- User Management
- Global Mute Management
- Operations Management
- Chatbots
- Official Account Management
- Webhooks
- Webhook Overview
- Webhook Command List
- Operations Management Callbacks
- Online Status Webhooks
- Relationship Chain Webhooks
- One-to-One Message Webhooks
- Group Webhooks
- 그룹 생성 전 콜백
- After a Group Is Created
- Before Applying to Join a Group
- Before Inviting a User to a Group
- After a User Joins a Group
- After a User Leaves a Group
- 그룹 내 발언 전 콜백
- 그룹 내 발언 후 콜백
- 그룹 만원 후 콜백
- After a Group Is Disbanded
- 그룹 정보 변경 후 콜백
- 그룹 메시지 회수 후 콜백
- Webhook for Online and Offline Status of Audio-Video Group Members
- Webhook for Exceptions When Group Messages Are Sent
- 토픽 생성 전 콜백
- 토픽 생성 후 콜백
- 토픽 해산 후 콜백
- 토픽 프로필 수정 후 콜백
- Callback After Group Member Profile Changed
- Callback After Group Attribute Changed
- Callback After Read Receipt
- Callback After the Group Owner Changed
- Webhooks related to the Official Account
- Before a Official Account Is Created
- After a Official Account Is Created
- After Official Account Profile Is Modified
- After Official Account Is Destroyed
- Before Official Account Is Subscribed
- After Official Account Is Subscribed
- After a Official Account Is Full
- After Official Account Is Unsubscribed
- Before Official Account Message Is Sent
- Callback After Sending an Official Account Message
- Webhook After Recalling Official Account Messages
- 콘솔 가이드
- FAQ
- 협약 및 인증
- IM 정책
- 에러 코드
- 문의하기
- 제품 소개
- 구매 가이드
- 다운로드 센터
- 시나리오 솔루션
- 클라이언트 APIs
- 서버 APIs
- Generating UserSig
- RESTful APIs
- RESTful API Overview
- RESTful API List
- Message Related
- Session Related
- Group Related
- Group Management
- Group Information
- Group Member Management
- Group Member Information
- Group Custom Attributes
- Live Group Management
- Setting Live Streaming Group Robots
- Deleting Live Streaming Group Robots
- Setting/Deleting Live Streaming Group Administrators
- Obtaining the List of Live Streaming Group Administrators
- Checking Whether Users Are in a Live Streaming Group
- Getting the Number of Online Users in an Audio-Video Group
- Getting the List of Online Members in Audio-Video Group
- Setting Audio-Video Group Member Marks
- Getting the List of Banned Group Members
- Community Management
- Creating Topic
- Deleting Topic
- Getting Topic Profile
- Modifying Topic Profile
- Importing Topic Profiles
- Permission Group Management
- Creating Permission Groups
- Terminating Permission Groups
- Modifying Permission Group Information
- Obtaining Permission Group Information
- Adding Topic Permissions
- Modifying Topic Permissions
- Deleting Topic Permissions
- Obtaining Topic Permissions
- Adding Members to a Permission Group
- Deleting Permission Group Members
- Obtaining Permission Group Member List
- Getting the List of Online Members in Community Group
- Group Counter
- User Management
- Global Mute Management
- Operations Management
- Chatbots
- Official Account Management
- Webhooks
- Webhook Overview
- Webhook Command List
- Operations Management Callbacks
- Online Status Webhooks
- Relationship Chain Webhooks
- One-to-One Message Webhooks
- Group Webhooks
- 그룹 생성 전 콜백
- After a Group Is Created
- Before Applying to Join a Group
- Before Inviting a User to a Group
- After a User Joins a Group
- After a User Leaves a Group
- 그룹 내 발언 전 콜백
- 그룹 내 발언 후 콜백
- 그룹 만원 후 콜백
- After a Group Is Disbanded
- 그룹 정보 변경 후 콜백
- 그룹 메시지 회수 후 콜백
- Webhook for Online and Offline Status of Audio-Video Group Members
- Webhook for Exceptions When Group Messages Are Sent
- 토픽 생성 전 콜백
- 토픽 생성 후 콜백
- 토픽 해산 후 콜백
- 토픽 프로필 수정 후 콜백
- Callback After Group Member Profile Changed
- Callback After Group Attribute Changed
- Callback After Read Receipt
- Callback After the Group Owner Changed
- Webhooks related to the Official Account
- Before a Official Account Is Created
- After a Official Account Is Created
- After Official Account Profile Is Modified
- After Official Account Is Destroyed
- Before Official Account Is Subscribed
- After Official Account Is Subscribed
- After a Official Account Is Full
- After Official Account Is Unsubscribed
- Before Official Account Message Is Sent
- Callback After Sending an Official Account Message
- Webhook After Recalling Official Account Messages
- 콘솔 가이드
- FAQ
- 협약 및 인증
- IM 정책
- 에러 코드
- 문의하기
기능 설명
이 콜백을 통해 App 백엔드에서 실시간으로 사용자의 토픽 생성 요청을 볼 수 있습니다. 또한 App 백엔드는 요청을 거부할 수 있습니다.
주의 사항
이 콜백을 활성화하려면 콜백 URL을 구성해야 합니다. 이 콜백과 그룹 생성 전 콜백은 동일한 스위치를 사용합니다. 자세한 지침은 콜백 설정을 참고하십시오.
이 콜백 중에 IM 백엔드는 App 백엔드에 대한 HTTP POST 요청을 시작합니다.
콜백 요청을 받은 후 App 백엔드는 요청 URL에 포함된 SDKAppID가 앱의 SDKAppID인지 확인해야 합니다.
보안 고려 사항에 대한 자세한 내용은 Webhook Overview: Security Considerations 섹션을 참고하십시오.
토픽 기능은 기능 설정 이후에만 사용 가능합니다.
콜백 트리거링 시나리오
App 사용자는 클라이언트에서 토픽을 생성합니다
App 관리자는 REST API를 통해 토픽을 생성합니다
콜백 트리거링 타이밍
IM 백엔드가 토픽을 생성하기 전에 트리거됩니다.
API 설명
요청 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.CallbackBeforeCreateTopic |
contenttype | 고정 값: JSON |
ClientIP | 클라이언트 IP, 형식: 127.0.0.1 |
OptPlatform |
요청 예시
{"CallbackCommand": "Group.CallbackBeforeCreateTopic", // 콜백 명령"Operator_Account": "leckie", // 운영자"Type": "Community", // 그룹 유형"Name": "MyFirstTopic" // 그룹 이름}
요청 필드
객체 | 유형 | 설명 |
CallbackCommand | String | 콜백 명령 |
Operator_Account | String | 토픽 생성 요청을 시작한 운영자의 UserID |
Type | String | 토픽의 그룹 유형, 여기는 Community |
Name | String | 생성을 요청한 토픽의 이름 |
응답 예시
생성 허용됨
사용자는 토픽을 만들 수 있습니다.
{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 0 // 생성 허용됨}
생성 거부됨
사용자는 토픽을 만들 수 없습니다. 토픽가 생성되지 않으며 호출자에게 에러 코드
10016이 반환됩니다.{"ActionStatus": "OK","ErrorInfo": "","ErrorCode": 1 // 생성 거부됨}
응답 필드
필드 | 유형 | 속성 | 설명 |
ActionStatus | String | 필수 | 요청 결과, OK: 성공 표시, FAIL: 실패 표시 |
ErrorCode | Integer | 필수 | 에러 코드, 유효한 값: 0: 생성 허용; 1: 생성이 거부됨, 고유한 에러 코드를 사용하여 토픽 생성에 대한 사용자 요청을 거부하려면 [10100,10200] 범위의 ErrorCode와 함께 ErrorCode 및 ErrorInfo를 클라이언트에 전달해야 합니다 |
ErrorInfo | String | 필수 | 에러 메시지 |
참고
REST API: 토픽 생성
예
아니오
문제 해결에 도움이 되었나요?