Token Oluşturma

Method	URL	İçerik Türü
POST	auth/api	application/json

Servise gönderilmesi gereken parametreler
Örnek İstek
Örnek cevaplar

Açıklama

API metodlarına istek atabilmek için kullanılması gereken bir token oluşturma metodudur. Bu metod, istemci tarafından çağrıldığında geçerli bir erişim belirteci (token) sağlar.
Oluşturulan token'ın geçerlilik süresi 8 saat olarak belirlenmiştir. Yani, bir token oluşturulduktan sonra 8 saat boyunca kullanılabilir.
Bir token, geçerliliğini yitirdiği durumda, API metodlarına erişim sağlamak için tekrar bu metodu kullanarak yeni bir token alınması gerekmektedir. Bu şekilde, güvenliği sağlamak ve sürekli erişimi güvence altına almak amaçlanmıştır.

TEST SUNUCUSUNA istek atabilmek için; https://domestic-qa.navlungo.com/ üzerinden üyelik oluşturup firma kaydınızı yaptıktan sonra, Api bilgilerinizi Entegrasyonlar bölümünden alabilirsiniz.

Servise Gönderilmesi gereken parametreler

Parametre ismi	Tip	Zorunluluk	Açıklama
username	string	evet	API Kullanıcı Adınız
password	string	evet	API Şifreniz

Örnek İstek

<?php 

$data = array(
    'username' => "__USERNAME__",
    'password' => "__PASSWORD__",

);

$payload = json_encode($data);

$ch = curl_init('__APIURL__/auth/api');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_HTTPHEADER, 
array(
   'Content-Type : application/json',
));

$result = curl_exec($ch);

curl_close($ch);

print_r($result);

?>

const https = require('https');

const data = JSON.stringify({
  'username' : "__USERNAME__",
  'password' : "__PASSWORD__",
});

const options = {
  hostname: '__APIURL__',
  path: '/v2/auth/api',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  }
};

const req = https.request(options, res => {
  console.log(`statusCode: ${res.statusCode}`);

  res.on('data', d => {
    process.stdout.write(d);
  });
});

req.on('error', error => {
  console.error(error);
});

req.write(data);
req.end();

import json
import requests

data = {
    'username': "__USERNAME__",
    'password': "__PASSWORD__",

}

payload = json.dumps(data)

headers = {
    'Content-Type': 'application/json',
}

response = requests.post('__APIURL__/auth/api', headers=headers, data=payload)

print(response.text)

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main(string[] args)
    {
        var data = new
        {
            username = "__USERNAME__",
            password = "__PASSWORD__",

        };

        var json = Newtonsoft.Json.JsonConvert.SerializeObject(data);

        using (var client = new HttpClient())
        {
            var request = new HttpRequestMessage
            {
                Method = HttpMethod.Post,
                RequestUri = new Uri("__APIURL__/auth/api"),
                Content = new StringContent(json, Encoding.UTF8, "application/json"),
            };
            request.Headers.Add("Authorization", "Bearer __TOKEN__");

            var response = await client.SendAsync(request);
            var result = await response.Content.ReadAsStringAsync();

            Console.WriteLine(result);
        }
    }
}

Örnek Servis Cevapları

{
    "status": true,
    "message": "Oturum başarıyla açıldı.",
    "data": {
        "token_type": "Bearer",
        "expires_in": "2023-05-23 20:22:37",
        "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiI5ODU5OGUxZC1kNThiLTQ5N2UtYmFkNS04ZTJiOWY2ZTI4YmIiLCJqdGkiOiJlM2NjYzM3NjgxNjM2OWRiYTNhOTA0YjFiZWU0YThjMzBhOGU2MDEwZTc0MTMzZDEwYjI1MWQ4MzFiMjMzZDRjMWIyMjU0MjZkYjY2ZjRkMCIsImlhdCI6MTY4NDgzMzc1Ny4zMzUxOTYsIm5iZiI6MTY4NDgzMzc1Ny4zMzUxOTgsImV4cCI6MTY4NDg2MjU1Ny4zMjI4NTIsInN1YiI6Ijg2Iiwic2NvcGVzIjpbInBvc3QuY3JlYXRlIiwicG9zdC51cGRhdGUiLCJwb3N0LmNoZWNrIiwicG9zdC5jYW5jZWwiXX0.N9GQw1-_H6poqtwgR48mN9lpZOC4OBA5giIRxbUC4-9rrq8PZaQU-LRWR-AspN4iOCYONjyITsVDwWjnYLnRT8IVSYHHuWhzOEKetm_jFHLlDmvnSQGFoZduWg6K8UXFZI3VUPnZ6k6_LE1vto9BhU1sIIS5qVFiaWcaS4YBuJxndeFe8FyzEb9CrVQa0ag9v5Irkv2H_7z-uqYnJ5Rw94HEHnQF-vUCHdxPr8L-XAe_5aCjwWgIv1UGyrp-AQc78pYCyt5nE-wc5bY32CvKOJc5iqEXX5HvPO9VJuh8Qc97ANv-FhN-tVUqQ_1PjmfyfEoTN_o1kablqxCRqrNJ2YIRZYYi6tM2S5l1io5sobmP_Hc5CxK53h4nYTY5sE_NjjbJ8w22t4oYse8oxtO1GL5CM15jYz55wKC3LQEN6Fma_vTMSopxn6E3Nv_AU87rGrsRRgr9n_9racCAdyRwbCC5b2ztQYMJqlOExFcYMR8jP5yxGg-1swgSTvSSFLSiYe9whHhNpSW0VfmMYCTXwAlDQzzChYVBK4KE1VsM0yLjd_eImarqEt64PARn_nt-GyizUY7LtQuZEs9SRlMF3P5DDSJ0S1Zh_Jk7kAH_ebGW61zD3aXI7Kupxv_38l82-F2pQOHzUYPxzOI-fLZGOlBQqj9KUBv3ONWQtNXfu-4"
    }
}

{
    "status": false,
    "error": "Geçersiz kullanıcı bilgileri."
}

{
    "message": "Doğrulama Hatası",
    "status": false,
    "error": {
        "username": [
            "Seçili Kullanıcı Adı geçersizdir."
        ]
    }
}

{
    "message": "Doğrulama Hatası",
    "status": false,
    "error": {
        "username": [
            "Kullanıcı Adı alanı gereklidir."
        ],
        "password": [
            "Şifre alanı gereklidir."
        ]
    }
}