GVI API Documentation
This is the documentation for GVI API. You can do something through API by user's login-info.
AuthToken
Authentication API to gain access to rest of API
↓↓↓
Authorization header=Base64Encode('Username:Password'). e.g: Base64Encode('test:123456')='dGVzdDoxMjM0NTY3OA=='
POST
/Auth/Token
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/Auth/Token" -H "Authorization: Basic
dGVzdDoxMjM0NTY3OA==" -d
""
Response
{
"token" : "zxETOKY3A72SRfpG3RT53Z1z1Sxi1qOu8Z5VLH8nOlC",
"expiration" : 1760863957
}
"token" : "zxETOKY3A72SRfpG3RT53Z1z1Sxi1qOu8Z5VLH8nOlC",
"expiration" : 1760863957
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/Auth/Token" -H "" -d
""
Response
{
"message" : "Missing authorization header"
}
"message" : "Missing authorization header"
}
EXAMPLE 3:
Curl
curl -X POST "https://api.gvi2u.com/Auth/Token" -H "Authorization: Basic
FAILSTRING" -d
""
Response
{
"message" : "Authentication failed"
}
"message" : "Authentication failed"
}
UserLogin
Get user-login link
↓↓↓
POST
/Auth/Login
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/Auth/Login" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"test@gvi2u.com\"}"
Response
{
"link" : "https://gvi2u.com/login/OBop14iAvKR2rc5fS15MxsOwIeRZ4PUYSX2vt9WW2KP",
"expired" 1761191357: }
"link" : "https://gvi2u.com/login/OBop14iAvKR2rc5fS15MxsOwIeRZ4PUYSX2vt9WW2KP",
"expired" 1761191357: }
UserList
Get user-list
↓↓↓
POST
/User/List
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/List" -H "Authorization: Bearer
[TOKEN]" -d
""
Response
{
"total" : 2,
"ranks" : [
{
rank_ID: 91,
rank_name: "GVI LEVEL A",
},
{
rank_ID: 1,
rank_name: "GVI LEVEL 0"
}
],
"users" : [
{
"user_ID": 11,
"user_parent_ID": 0,
"user_rank_ID": 91,
"user_login": "test1",
"user_email": "test1@gvi2u.com",
"user_phone": "-"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
},
{
"user_ID": 12,
"user_parent_ID": 11,
"user_rank_ID": 1,
"user_login": "test2",
"user_email": "test2@gvi2u.com",
"user_phone": "6012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
]
}
"total" : 2,
"ranks" : [
{
rank_ID: 91,
rank_name: "GVI LEVEL A",
},
{
rank_ID: 1,
rank_name: "GVI LEVEL 0"
}
],
"users" : [
{
"user_ID": 11,
"user_parent_ID": 0,
"user_rank_ID": 91,
"user_login": "test1",
"user_email": "test1@gvi2u.com",
"user_phone": "-"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
},
{
"user_ID": 12,
"user_parent_ID": 11,
"user_rank_ID": 1,
"user_login": "test2",
"user_email": "test2@gvi2u.com",
"user_phone": "6012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
]
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/List" -H "Authorization: Bearer
EXPIRED-TOKEN" -d
""
Response
{
"message" : "Authentication expired"
}
"message" : "Authentication expired"
}
UserOtp
Get user-otp
↓↓↓
POST
/User/Otp
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/List" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"test@gvi2u.com\"}"
Response
{
"OTP" : 1234
}
"OTP" : 1234
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/List" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"not-existed-user@gvi2u.com\"}"
Response
{
"message" : "No account is matched for [not-existed-user@gvi2u.com]"
}
"message" : "No account is matched for [not-existed-user@gvi2u.com]"
}
UserInfo
Get user-info
↓↓↓
POST
/User/Info
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/Info" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"test@gvi2u.com\"}"
Response
{
"user_ID" : 2,
"user_parent_ID" : 1,
"user_rank_ID" : 1,
"user_pass" : "G123456",
"user_login" : "gvi",
"user_email" : "gvi@gmail.com",
"user_phone" : "012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
"user_ID" : 2,
"user_parent_ID" : 1,
"user_rank_ID" : 1,
"user_pass" : "G123456",
"user_login" : "gvi",
"user_email" : "gvi@gmail.com",
"user_phone" : "012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/Info" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"not-existed-user@gvi2u.com\"}"
Response
{
"message" : "The user[not-existed-user@gvi2u.com] is not exist. "
}
"message" : "The user[not-existed-user@gvi2u.com] is not exist. "
}
UserReset
Get user-reset
↓↓↓
POST
/User/Reset
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/Reset" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"test@gvi2u.com\"}"
Response
{
"user_ID" : 1234
}
"user_ID" : 1234
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/Reset" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"not-existed-user@gvi2u.com\"}"
Response
{
"message" : "The user[not-existed-user@gvi2u.com] is not exist. "
}
"message" : "The user[not-existed-user@gvi2u.com] is not exist. "
}
UserAdd
Add user
↓↓↓
POST
/User/Add
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/Add" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_login\":\"gvi\",\"parent_email\":\"p-gvi@gvi.com\",\"user_email\":\"gvi@gmail.com\",\"user_phone\":\"012345678\"}"
Response
{
"user_ID" : 2,
"user_parent_ID" : 1,
"user_rank_ID" : 1,
"user_pass" : "A12346",
"user_login" : "gvi",
"user_email" : "gvi@gmail.com",
"user_phone" : "012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
"user_ID" : 2,
"user_parent_ID" : 1,
"user_rank_ID" : 1,
"user_pass" : "A12346",
"user_login" : "gvi",
"user_email" : "gvi@gmail.com",
"user_phone" : "012345678"
"user_refer_code" : "A0001"
"user_create_time" : 1760863957
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/Add" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_login\":\"gvi\",\"parent_email\":\"not-exist-parent@gvi.com\",\"user_email\":\"gvi@gmail.com\",\"user_phone\":\"012345678\"}"
Response
{
"message" : "The parent-email is not matched any existed user. [not-exist-parent@gvi.com]"
}
"message" : "The parent-email is not matched any existed user. [not-exist-parent@gvi.com]"
}
UserDel
Delete user
↓↓↓
POST
/User/Del
EXAMPLE 1:
Curl
curl -X POST "https://api.gvi2u.com/User/Del" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"gvi@gvi.com\"}"
Response
{
"deleted_user_ID" : 312
}
"deleted_user_ID" : 312
}
EXAMPLE 2:
Curl
curl -X POST "https://api.gvi2u.com/User/Del" -H "Authorization: Bearer
[TOKEN]" -d
"{\"user_email\":\"old_user@gvi.com\"}"
Response
{
"message" : "Some user was a child of this account(sun lines). Cannot delete this account"
}
"message" : "Some user was a child of this account(sun lines). Cannot delete this account"
}