#
Description
- Notification of changes in the number of matching users
Request Method
- HTTPS
- POST
- Parameters are in JSON format and placed in the body.
Request Parameters (additional fields may be added, please keep compatibility with the added fields on the server side)
| Parameter Name |
Required |
Type |
Description |
Example |
| notify_id |
Yes |
string |
Notification ID |
0795d77f85789da0eb387a5096 |
| notify_time |
Yes |
string |
Server-side timestamp (in milliseconds) when the notification was sent |
1647834452408 |
| app_id |
Yes |
string |
Application ID of the message recipient |
1 |
| notify_event |
Yes |
string |
Notification event |
sud.mg.merchant.match.user.changed |
| data |
Yes |
MatchUserChangedModel |
Notification data |
{} |
MatchUserChangedModel
| Parameter Name |
Required |
Type |
Description |
Example |
| group_id |
Yes |
string |
Match group ID |
14615640800525066 |
| cur_num |
Yes |
int32 |
Number of users already matched |
2 |
| total_num |
Yes |
int32 |
Total number of users to match |
4 |
| user_ids |
Yes |
string array |
IDs of users already matched (IDs of users in other apps are not included in this list) |
['u01', 'u02'] |
Message Signature Verification
Verification
Request Example
{
"notify_id": "144884c98000100c-15da5e428a821000",
"notify_time": "1664266669547",
"app_id": "1461564080052506636",
"notify_event": "sud.mg.merchant.match.user.changed",
"data": {
"group_id": "g01",
"cur_num": 2,
"total_num": 4,
"user_ids": ['u01', 'u02']
}
}
Notification Response
| Parameter Name |
Required |
Type |
Description |
Example |
| ret_code |
Yes |
int32 |
Return status code. 0 indicates successful notification, other error codes indicate failure. |
0 |
| ret_msg |
Yes |
string |
Return message |
SUCCESS |
Response Example
{
"ret_code": 0,
"ret_msg": "SUCCESS",
}