Agent Request API

Prerequisites

• Test Environment

  https://test.fuyalive.top/api

• Production Environment

   

• Test AppID

  appid:123456820

  payPassward:123456

• Test public key

  xxxxxxxxxx
  9
  1
  -----BEGIN RSA PUBLIC KEY-----
  2
  MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAxG1Pb+LMXLbUuuebPA60
  3
  1U3lwovUAK/xbR6biqqCiGCCNYmKunMZlt5xjmC9h5D+MA90gSrPProAu2n6Ocfw
  4
  3mDTcSP7tRq1Ypr5joZ74YCsbw/+3xSgVzqKVc87vDkcAuQ0Km/5lXesB9PY+UgE
  5
  ZK6AJRLh99AdE0/Y3tUyVEe+qjpzvxjUaU5mamfx6iryG6tpeLCqV0qk0QZg7g+1
  6
  gB/zAbxryIcD1v3fFsOSLyMwVmfD97RAeRfvJ68GgCl12TwVdCaVmKzgkiyBb6Mo
  7
  J/8lE1wBl+LFzToT3ub5g6MZdf6Q59y6eLa54yvkwm7x36WPeuIwiV/2tffVjTCm
  8
  FQIDAQAB
  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

• 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

• Response Parameters

• 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

• Response Parameters

• Response Example

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

5.Retrieve Gift Items

• Request URL

  /agent/api/agent-props

• Request Method

  POST

• Request Parameters

• 返回参数

• 返回示例

xxxxxxxxxx
18
1
{
2
    "code": 0,
3
    "message": "success",
4
    "data": [
5
        {
6
            "props_name": "Crystal Vip",
7
            "props_icon": "https://static.fuyalive.top/common/vip/Crystal.png",
8
            "props_day": 30,
9
            "props_type": 2,
10
            "props_link": 1,
11
            "count": 2,
12
            "props_ids": [
13
                136,
14
                137
15
            ]
16
        }
17
    ]
18
}

###

Status Codes