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"