Agent Request API

Prerequisites

Test Environment
https://test-h5.hzshtech.cn/api
Production Environment
Test AppID
appid:123457945
payPassward:125678

Test public key


xxxxxxxxxx
9
1
-----BEGIN RSA PUBLIC KEY-----
2
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxECrth+d5t2eCb8GBOXx
3
JXSdNOs8JiGtJPUWYwTgTQprFI4p+3I17udgRhOiv+yJc5CHB9ietXcsWpVk3245
4
LuFM6dCAMw1ioJTqyh2DEPYKrnj43nqpxkIg/SmCAPiisAEVGaGfuvf19TNp8LZm
5
hGmHAZu04/QjdeVZHhIwEkLklSxf5H6YGIjZrUHSPDotsvSWBd2fMMy3vqQnvIBJ
6
V4c0BLolBqAG7qMG5hsUt66Bl/7QXNthmXM7SPkpYsyfJq6m0lmq6jpHE6uACsJs
7
s2xDU50ZntgWpoAoE1vk/r+6XKGm9G6vqa9fEozDxGiEBhZxozGTrY7cEiInY1U7
8
7QIDAQAB
9
-----END RSA PUBLIC KEY-----

Request Method

Add appid and sign to the header.
appid is the agent user ID.
sign: The parameters are encrypted using the EncryptPKCS1v15 public key, and the parameters do not need to be hashed.
No need to put parameters in the body


xxxxxxxxxx
4
1
curl -X POST http://localhost:8080/agent/api/check-user \
2
-H "Content-Type: application/json" \
3
-H "appid:<your appid>" \
4
-H "sign: <sign>" \

Interface Request Limitations
- One request per interface every 30 seconds
Status Code See Below

1.User Verification

Request URL
/agent/api/check-user
Request Method
POST
Request Parameters
Field Name Type Required Remarks
user_id int Yes User ID
app_id int Yes App ID
request_time int Yes request time,timestamp in seconds
Response Parameters
Field Name Type Remarks
user_id int User ID
nickname string Nickname
portrait string Avatar

Field Name	Type	Required	Remarks
user_id	int	Yes	User ID
app_id	int	Yes	App ID
request_time	int	Yes	request time,timestamp in seconds

Field Name	Type	Remarks
user_id	int	User ID
nickname	string	Nickname
portrait	string	Avatar

Response Example


xxxxxxxxxx
9
1
{
2
    "code": 0,
3
    "message": "success",
4
    "data": {
5
        "user_id": 123457947,
6
        "nickname": "sss",
7
        "portrait": "https://istatic.imamolive.top//common/fuya_def_head.png"
8
    }
9
}

2. Retrieve Transfer Records

Request URL
/agent/api/transfer-record
Request Method
POST

Request Parameters

Field Name	Type	Required	Remarks
page	int	Yes	Page number, starting from 0
size	int	Yes	Number of records per page
start_time	int	No	Start time, timestamp in seconds
end_time	int	No	End time, timestamp in seconds
target_user_id	int	No	Target user ID
app_id	int	Yes	App ID
request_time	int	Yes	request time,timestamp in seconds

Response Parameters

Field Name	Type	Remarks
order_id	int	order_id
user_id	int	User id
target_user_id	int	Platform order ID
one_price	float	unit price
cost_price	float	Cost unit price
diamonds	int	amount
before_change	int	Before balance
after_change	int	After balance
certificate_url	string	voucher
payment_id	int	channel
payment_name	string	channel name
link_order_id	string	Your order id
create_time	int	create time
update_time	int	update time

Response Example


xxxxxxxxxx
25
1
{
2
    "code": 0,
3
    "message": "success",
4
    "data": {
5
        "count": 1,
6
        "list": [
7
            {
8
                "order_id": 1850,
9
                "user_id": 123457945,
10
                "target_user_id": 123457947,
11
                "one_price": 0.28,
12
                "cost_price": 0.2740500025,
13
                "diamonds": 100000,
14
                "before_change": 999999799999,
15
                "after_change": 999999699999,
16
                "certificate_url": "",
17
                "payment_id": 0,
18
                "payment_name": "",
19
                "link_order_id": "oid123451678",
20
                "create_time": 1744615890,
21
                "update_time": 1744615890
22
            }
23
        ]
24
    }
25
}

3.Transfer

Please call /agent/api/check-user before using, otherwise error 4005 will occur

Request URL
/agent/api/transfer-diamond
Request Method
POST
Request Parameters

Field Name	Type	Required	Remarks
target_user_id	int	Yes	Target user ID
app_id	int	Yes	app_id
diamonds	int	Yes	diamonds
pay_password	string	Yes	pay password(Please refer to the following figure for details)
link_order_id	string	Yes	Your order id
request_time	int	Yes	request time,timestamp in seconds

Response Parameters

Field Name	Type	Remarks
remain_diamonds	int	Remaining Diamonds
balance_money	int	Agent Balance
order_id	Int	Platform order ID

Response Example


xxxxxxxxxx
8
1
{
2
    "code": 0,
3
    "message": "success",
4
    "data": {
5
        "remain_diamonds": 51151144,
6
        "balance_money": 119380500
7
    }
8
}

Tap on "Payment Password" to set the payment password.

4.Account

Request URL
/agent/api/account
Request Method
POST
Request Parameters

Field Name	Type	Required	Remarks
app_id	int	Yes	app_id
request_time	int	Yes	request time,timestamp in seconds

Response Parameters

Field Name	Type	Remarks
remain_diamonds	int	Remaining Diamonds
balance_money	int	Agent Balance

Response Example


xxxxxxxxxx
8
1
{
2
    "code": 0,
3
    "message": "success",
4
    "data": {
5
        "remain_diamonds": 51151144,
6
        "balance_money": 119380500
7
    }
8
}

Status Codes

code	Remarks
0	Success
500	Request Failed
1000	Parameter Error
1001	Request time difference of 60 seconds
1053	frequent operations
4001	IP Inaccessible
4002	Sign is Empty
4003	Unauthorized agent user
4004	Sign Error, Parsing Failed
4005	Operation Error, No Verification of Transfer User 10 Minutes Before Transfer
4006	Agent Account Exception
4007	Incorrect Payment Password
4008	Insufficient Balance
4009	Order Repeat
4010	Cannot transfer funds across regions