Barkod Oluştur

Method	URL	İçerik Türü
POST	barcode/getBarcode	application/json

Servise gönderilmesi gereken zorunlu başlıklar
Servise gönderilmesi gereken parametreler
Örnek İstek
Örnek cevaplar

Açıklama

Bu metod, mevcut gönderinin farklı formatlarda barkodunu oluşturmak için kullanılır.

Servise Gönderilmesi gereken zorunlu başlıklar

Parametre ismi	Tip	Zorunluluk	Açıklama
Authorization	Bearer	evet	auth/login metodundan aldığınız token

Servise Gönderilmesi gereken parametreler

Parametre İsmi	Tip	Zorunluluk	Açıklama
post_number	string	evet	Gönderi Numarası
barcode_type (*)	string	evet	Barkod formatı (örn: pdf)

Parametre ismi	Değer	Açıklama
*() barcode_type**	pdf, html, zpl	Tercih edilen barkod formatı
	pdf	Pdf türünde base64 ve barkod adresi çıktısı sunar
	html	HTML türünde base64 ve barkod adresi çıktısı sunar
	zpl	Pdf türünde base64 ve barkod adresi çıktısı sunar. Bu format sadece Aras Kargo ve HepsiJet taşıyıcılarında kullanılabilmektedir. ZPL barkod isteği yapıldığında taşıyıcının barkod çıktısı verilmektedir. ZPL kodu olarak geri dönüş yapılmamaktadır.

Örnek İstek

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => '__APIURL__/barcode/getBarcode',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "post_number": "XXX123",
    "barcode_type": "pdf"
}',
  CURLOPT_HTTPHEADER => array(
    'X-localization: tr',
    'Content-Type: application/json',
    'Authorization: Bearer __TOKEN__'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

const axios = require('axios');

let data = JSON.stringify({
  "post_number": "XXX123",
  "barcode_type": "pdf"
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: '__APIURL__/barcode/getBarcode',
  headers: { 
    'X-localization': 'tr', 
    'Content-Type': 'application/json', 
    'Authorization': 'Bearer __TOKEN__', 
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

import requests
import json

url = "__APIURL__/barcode/getBarcode"

payload = json.dumps({
  "post_number": "XXX123",
  "barcode_type": "pdf"
})
headers = {
  'X-localization': 'tr',
  'Content-Type': 'application/json',
  'Authorization': 'Bearer __TOKEN__'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "__APIURL__/barcode/getBarcode");

request.Headers.Add("X-localization", "tr");
request.Headers.Add("Authorization", "Bearer __TOKEN__");

var content = new StringContent("{\n    
\"post_number\": \"RT19S9JENV\",\n    
\"barcode_type\": \"pdf\"\n}", null, "application/json");

request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Örnek Servis Cevapları

{
    "status": true,
    "message": "Barkod başarıyla oluşturulmuştur.",
    "data": {
        "barcode_type": "pdf",
        "barcode_url": "https://domestic-qa-barcode.navlungo.com/XXX123.pdf",
        "barcode_pdf": "base64 Barcode String",
        "barcode_html": ""
    }
}

{
    "status": false,
    "error": "Bu kaynağa erişim yetkiniz yoktur."
}

{
    "status": false,
    "error": "Bu gönderi taşıyıcıda oluşturulamadığı için barkod çıktısı alınamamaktadır."
}

{
    "message": "Doğrulama Hatası",
    "status": false,
    "error": {
        "barcode_type": [
            "Barkod Tipi değeri geçersizdir."
        ]
    }
}

{
    "message": "Doğrulama Hatası",
    "status": false,
    "error": {
        "post_number": [
            "Gönderi Numarası alanı gereklidir."
        ],
        "barcode_type": [
            "Barkod Tipi alanı gereklidir."
        ]
    }
}

{
    "status": false,
    "error": "Servis hatası. Yardım için Takip No: #eventId ile iletişime geçebilirsiniz."
}

{
    "status": false,
    "error": "ZPL barkod oluşturulurken bir hata oluştu."
}