Skip to main content

Introduction

Our HTTP REST API allows you to manage vital details of your account and services in client portal. JSON is used for all API returns

Use left menu to browse trough available methods, use right menu to check required parameters, data to post and code samples in various languages.

Endpoint​

https://api.tino.vn

Header Options​

For language: Accept-Language: langname (vietnamese/english)

Host:

X-Forwarded-Host: 'my.tino.vn' (Required for Client)

X-Forwarded-Host: 'daily.tino.vn' (Required for Reseller)

Content Type: Content-Type: application/json

Example:

curl --location --request POST 'https://api.tino.vn/login' \
--header 'Accept-Language: vietnamese' \
--header 'X-Forwarded-Host: my.tino.org' \
--header 'Content-Type: application/json' \
--data-raw '{
"username": "email@email.com",
"password": "password"
}'

Authentication​

We support 2 authentication methods as follows.

1. JSON Web Token Authentication​

To authenticate, you need to send a JSON Web Token (JWT) in the authorization header of the HTTP request.

To obtain the authorization token you need to submit a request with your username and password to POST https://api.tino.vn/login API method

All API calls that require authentication expect HTTP header in the form of Authorization: Bearer

curl --location --request POST 'https://api.tino.vn/token' \
--header 'Accept-Language: vietnamese' \
--header 'X-Forwarded-Host: my.tino.org' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer `Token` \
--data-raw '{
"refresh_token": 'refresh_token'
}

Example Request token

   curl 'https://api.tino.vn/login' \
-d username="username"\
-d password="password"
$resp = $client->post('/login', [
'form_params' => [
'username' => 'username',
'password' => 'password'
]
]);

$token = $resp->json()['token'];

$resp = $client->get('/details', [
'headers' => [
'Authorization' => 'Bearer ' . $token
]
]);

echo $resp->getBody();

2. Basic Authentication​

This authentication method requires that you send your client area username (email address) and password with each request.

API calls that require authentication expect a header in the form of Authorization: Basic credentials, where credentials is the Base64 encoding of username and password joined by a single colon :.

# pass the correct header with each request (-u option)
curl 'https://api.tino.vn/details' \
-u "username:password"