Points (REST)
Endpoint
Real Server : https://api.finenex.net/v1
Test Server : https://test1-api.finenex.net/v1
Authentication
To make a request, you need to include the JWT in the HTTP header. JWT can be received through the authentication server.
Example
If JWT is "eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NDgyMDc1OTIsImlhdCI6MTY0ODEyMTE5Mn0.AYNcBLhKqtqwzxNm7kOREEUH0_3gFevOXxI94TBORao",
curl -X 'POST' \
'{endpoint}/nlp/issue' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NDgyMDc1OTIsImlhdCI6MTY0ODEyMTE5Mn0.AYNcBLhKqtqwzxNm7kOREEUH0_3gFevOXxI94TBORao' \
-H 'Content-Type: application/json' \
-d '{
"tokenAmount": "10"
}'
API References
Issue
Token name (nlp or nuri)
Token amount
Store TID
POST /v1/points/{name}/issue HTTP/1.1
Host: test1-api.finenex.net
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 35
{
"tokenAmount": "text",
"tid": "text"
}
Points issued successfully
{
"rewardId": "text",
"tokenSymbol": "text",
"tokenAmount": "text",
"contractAddress": "text",
"rewardDate": "text"
}
Example
curl -X 'POST' \
'{endpoint}/points/nlp/issue' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NTIyNzgxNTgsImlhdCI6MTY1MjE5MTc1OH0.MqMd26110LlpuVrY-17so_WJ0icVlom0iqbp_0dVo58' \
-H 'Content-Type: application/json' \
-d '{
"tokenAmount": "10",
"tid": "test01"
}'
Accumulate
Token name (nlp or nuri)
Reward ID
Token amount
User wallet address to accumulate
POST /v1/points/{name}/{rewardId}/accumulate HTTP/1.1
Host: test1-api.finenex.net
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 43
{
"tokenAmount": "text",
"userAddress": "text"
}
Points are accumulated successfully
{
"userAddress": "text",
"tokenSymbol": "text",
"tokenAmount": "text",
"contractAddress": "text"
}
Example
curl -X 'POST' \
'{endpoint}/points/nlp/6500627A723D0000/accumulate' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NTIyNzgxNTgsImlhdCI6MTY1MjE5MTc1OH0.MqMd26110LlpuVrY-17so_WJ0icVlom0iqbp_0dVo58' \
-H 'Content-Type: application/json' \
-d '{
"tokenAmount": "10",
"userAddress": "user-address"
}'
Status
Token name (nlp or nuri)
Reward ID
GET /v1/points/{name}/{rewardId}/status HTTP/1.1
Host: test1-api.finenex.net
Authorization: Bearer JWT
Accept: */*
Return successfully
{
"userAddress": "text",
"accumulated": true,
"tokenSymbol": "text",
"contractAddress": "text"
}
Example
curl -X 'GET' \
'{endpoint}/points/nlp/6500627A723D0000/status' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NTIyNzgxNTgsImlhdCI6MTY1MjE5MTc1OH0.MqMd26110LlpuVrY-17so_WJ0icVlom0iqbp_0dVo58'
Cancel
Token name (nlp or nuri)
Reward ID
Token amount
POST /v1/points/{name}/{rewardId}/cancel HTTP/1.1
Host: test1-api.finenex.net
Authorization: Bearer JWT
Content-Type: application/json
Accept: */*
Content-Length: 22
{
"tokenAmount": "text"
}
Canceled successfully
{
"userAddress": "text",
"tokenSymbol": "text",
"tokenAmount": "text",
"contractAddress": "text"
}
Example
curl -X 'POST' \
'{endpoint}/points/nlp/6500627A723D0000/cancel' \
-H 'accept: application/json' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ0ZXN0MTExQGRzdGEuY29tIiwicm9sZSI6IlJPTEVfU1RPUkUiLCJleHAiOjE2NTIyNzgxNTgsImlhdCI6MTY1MjE5MTc1OH0.MqMd26110LlpuVrY-17so_WJ0icVlom0iqbp_0dVo58' \
-H 'Content-Type: application/json' \
-d '{
"tokenAmount": "10"
}'
Error Codes (resCode)
200: Success
400: Bad parameters
401: Unauthenticated
404: Not found
500: Internal server error. Please see resMessage
Last updated