Qq group

GroupI. The union binds groups (QQ)1.1 Interface name1.2 Request parameters1.3 Return parameters1.4 Request exampleII. Query group relationship (QQ or WeChat)2.1 Interface name2.2 Request parameters2.3 Return parameters2.4 Request exampleIII. Join an existing group (QQ)3.1 Interface name3.2 Request parameters3.3 Return parameters3.4 Request exampleIV. Unbind groups (QQ or WeChat)4.1 Interface name4.2 Request parameters4.3 Return parameters4.4 Request exampleV. Launch a QQ group list (QQ)5.1 Interface name5.2 Request parameters5.3 Return parameters5.4 Request exampleVI. Bind the created QQ groups (QQ)6.1 Interface name6.2 Request parameters6.3 Return parameters6.4 Request exampleVII. Remind the president to bind groups (QQ)7.1 Interface name7.2 Request parameters7.3 Return parameters7.4 Request exampleVIII. Launch group information (QQ or WeChat)8.1 Interface name8.2 Request parameters8.3 Return parameters8.4 Request exampleXI. Send group messages (WeChat)9.1 Interface name9.2 Request parameters9.3 Return parametersX. Send group messages (QQ)10.1 Interface name10.2 Request parameters10.3 Return parameters10.4 Request example 03/21/2025 15:06:03 For detailed description of the union group process and the permission application process, please refer to Group Module. I. The union binds groups (QQ)The union president creates and binds QQ groups directly (permissions are required to use this function).1.1 Interface name/v2/group/create_bind_group1.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statusguild_idstring[Required] Union IDguild_namestring[Required] union nameroleidstring[Required] Role IDzone_idstring[Required] zone ID, which is the zone ID of the union herepartitionstringpartition ID, which can be left blank and is temporarily uselessuser_zone_idstringUser's zone ID (can be left blank). The president can transfer the ID to someone who is not in this zone, so the union's zone is not necessarily the user's zone. It can be left blank when it is the same as the union zoneuser_namestringUser's nicknameareaidstringThe ID of the game area, which theoretically only has two values: 1: QQ, 2: WeChat, but may have many virtual values in the test environment1.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return resultgroupidstringGroup ID of the new groupgroup_namestringGroup name1.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "guild_id":"2134", "guild_name":"testitop", "zone_id":"1", "roleid":"2" }Returned package { "ret":0, "msg":"", "groupid":"735088906", "group_name":"testitop" }II. Query group relationship (QQ or WeChat)After the union has been bound to a group, this interface can be invoked to query information about the relationship between the user and the group. It can return such information (group owner, administrator, common member, and non-member) (you need to apply for permission when using it).2.1 Interface name/v2/group/get_group_rela_info2.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statusgroupidstring[Rrequired for QQ] group IDguild_idstring[Required for WeChat] Union IDWarning: Don't confuse groupid and guild_id; the former is QQ group ID, and the latter is the Union ID in the game.2.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return resultrelationintThe relation between the user and the group, 1: group owner, 2: administrator, 3: common member, 4: non-member. WeChat's value range can only be 3 or 42.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "groupid":"735088906" }Returned package { "ret":0, "msg":"", "relation":1 }III. Join an existing group (QQ)This interface is used for in-game union members to join a QQ group; before invoking this interface, invoke /v2/group/get_group_info interface to query whether the user is a group member; if the user is not a group member, the

Groups (QQ)This interface is used for the union president to bind the union to the QQ groups he has created; before invoking this interface, invoke /v2/group/get_group_list interface to launch the created group list.6.1 Interface name/v2/group/bind_existing_group6.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statusgroupidstring[Required] Group IDgroup_namestring[Required] Group nameguild_idstring[Required] Union IDzone_idstring[Required] Zone ID, which is the zone ID of the union hereroleidstringRole IDpartitionstringzone IDuser_zone_idstringUser zone ID; the union president can transfer the ID to someone who is not in this zone, so a union zone is not necessarily a user zone. The user zone ID can be left blank when the user zone is the same as the union zoneareaidstringThe ID of the game area, which theoretically only has two values: 1: QQ, 2: WeChat, but may have many virtual values in the test environmentWarning: Don't confuse groupid and guild_id; the former is QQ group ID, and the latter is the Union ID in the game.6.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return result6.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "guild_id":"2134", "groupid":"735088906", "group_name":"testitop", "zone_id":"1" }Returned package { "ret":0, "msg":"" }VII. Remind the president to bind groups (QQ)This interface is used for union members to remind the union president to bind a group when the union is not bound to the group; let the union bind the QQ group I have created, so that I can receive notifications through the Official Account "QQ Mobile Games" but is limited to receive only one notification per day; it is needed to verify that the reminder and the reminded one must be union members, and the game side ensures that the reminded one is the union president.7.1 Interface name/v2/group/remind_leader_bind7.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statusguild_idstring[Required] Union IDroleidstring[Required] Role IDleader_openidstring[Required] openId of the union presidentleader_roleidstring[Required] Role IDzone_idstring[Required] Zone ID, which is the zone ID of the union hererolenamestringRole name, used for message textleader_zone_idstringThe union president's zone ID; the president can transfer the ID to someone who is not in this zone; the field can be left blank when it is the same as the union zone IDareaidstringThe ID of the game area, which theoretically only has two values: 1: QQ, 2: WeChat, but may have many virtual values in the test environment7.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return result7.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "guild_id":"2135", "roleid":"2", "leader_openid":"D08BF5F51A67414795F602000B000000", "leader_roleid":"2", "zone_id":"1" }Returned package { "ret":0, "msg":"" }VIII. Launch group information (QQ or WeChat)8.1 Interface name/v2/group/get_group_info8.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statuschannel_infoobject[Required] Channel-related parameterschannel_infoQQ:ParameterTypeDescriptionguild_idstring[Required] Union IDzone_idstring[Required] Zone ID, which is the zone ID of the union hereWeChat:ParameterTypeDescriptionguild_idstring[Required] Union ID8.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return resultchannel_infoobjectChannel-related returnchannel_infoQQ:ParameterTypeDescriptiongroupidstringGroup IDgroup_namestringGroup namegroup_keystringgroup_key of the QQ group bound to the game Union IDgroup_openidstringgroup_openid of the QQ group bound to the game Union IDWeChat:ParameterTypeDescriptionis_hasint0 means that no group has been created, 1 means that a group has been created8.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "channel_info":{ "guild_id":"2135", "zone_id":"1" } }Returned package { "ret":0, "msg":"", "channel_info":'{ "groupid":"737550331", "group_name":"itopv2", "group_key":"hLG0YFQgoCIpQ-6_wo4yPXize0JbkzNu", "group_openid":"E571324A65B103B992714A6720DB4EBB"

"Join Group" button (new) will be displayed (the user needs to apply for permission when using it).3.1 Interface name/v2/group/join_group3.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statusguild_idstring[Required] Union IDgroupidstring[Required] group IDzone_idstring[Required] Zone ID, which is the zone ID of the union hereroleidstring[Required] Role IDareaidstringUsed in the test environment: game area ID, which theoretically has only two values 1: QQ, 2: WeChat, but may have many virtual values in the test environmentpartitionstringzone IDuser_zone_idstringUser zone ID; the union president can transfer the ID to someone who is not in this zone, so a union zone is not necessarily a user zone. The user zone ID can be left blank when the user zone is the same as the union zoneWarning: Don't confuse groupid and guild_id; the former is QQ group ID, and the latter is the Union ID in the game.3.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return result3.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "guild_id":"2134", "groupid":"706990493", "zone_id":"1" }Returned package { "ret":0, "msg":"" }IV. Unbind groups (QQ or WeChat)If the user voluntarily dissolves the trade union QQ group, the trade union and the trade union QQ group will not be automatically unbound.PS: There are two ways for a group to cancel its binding relationship with the union: The union president invokes the unbinding interface to dissolve the relationshipWhen a union member invokes the group joining interface, if he or she cannot query the group ID at this time, then he or she is thought to unbind the relationship by defaultIf a QQ group is disbanded without any of the above operations, the binding relationship will not disappear automaticallyAfter the union president resigns, the new president can also unbind the relationship.4.1 Interface name/v2/group/unbind_group4.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login statuschannel_infoobject[Required] Channel-related parameterschannel_info fieldQQ:ParameterTypeDescriptionguild_idstring[Required] Union IDguild_namestring[Required] Union namezone_idstring[Required] Zone ID, which is the zone ID of the union hereroleidstring[Required] Role IDareaidstringUsed in the test environment: game area ID, which theoretically has only two values 1: QQ, 2: WeChat, but may have many virtual values in the test environmentuser_zone_idstringUser zone ID; the union president can transfer the ID to someone who is not in this zone, so a union zone is not necessarily a user zone. The user zone ID can be left blank when the user zone is the same as the union zoneWeChat:ParameterTypeDescriptionguild_idstring[Required] Union ID4.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return result4.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A", "channel_info":{ "guild_id":"2135", "guild_name":"itopv2", "zone_id":"1" } }Returned package { "ret":0, "msg":"" }V. Launch a QQ group list (QQ)This interface is used to launch the created group list when the union president binds the union to the QQ groups created by him.5.1 Interface name/v2/group/get_group_list5.2 Request parametersParameterTypeDescriptionopenidstring[Required] User's unique IDtokenstring[Required] User's login status5.3 Return parametersParameterTypeDescriptionretintReturn code 0: success, others: failuremsgstringDetailed description of the return resultgroup_listarraya list of groups created by meIn group_list, each data contains a list of fieldsParameterTypeDescriptiongroupidstringGroup IDgroup_namestringGroup name5.4 Request exampleRequest { "openid":"D08BF5F51A67414795F602000B000000", "token":"6A27E8C2B4EB505BB6D4A230BDDEF00A" }Returned package { "ret":0, "msg":"", "group_list":[{ "groupid":"735088906", "group_name":"testitop" }] }VI. Bind the created QQ