აპი დოკუმენტაცია

This API version will be deprecated on 31/03/2024. Please use v1 version.

1. Store Booking API

API Endpoint: https://deliverers.ge/app/booking_api

Method: POST

Description: This API is used to create a new booking with specific client and customer details.

Request Parameters:

Parameter Type Description Example
keyclient_id INT The client ID provided by the admin. your_client_id
client_secret_key String The client secret key provided by the admin. sdfsd78s7df76s8df68s68sd6f8sd7f6s8dz7f68asd68a6823846382
keytimezone String The current timezone of the country. Asia/Tbilisi
keybooking_item_data Object Data about the booking item. Contains keys below. JSON Object

Key Inside keybooking_item_data:

Key Type Description Example
keycustomer_name String The name of the customer. John Doe
keycustomer_phone String The phone number of the customer. 1234567890
keycomments String Comments for the booking. Urgent delivery
keypickup_address String Pickup address for the booking. 29a Batumi Street, Tbilisi, Georgia
keydropoff_address String Drop-off address for the booking. Dighomi Massive, Tbilisi, Georgia

Sample Request:


$service_url = 'https://deliverers.ge/app/booking_api';
$curl = curl_init($service_url);
$curl_post_data = array(
    'keyclient_id'      => 'keyclient_id',
    'client_secret_key' => 'client_secret_key',
    'keytimezone'       => 'Asia/Tbilisi',
    'keybooking_item_data' => json_encode(array(
        "booking_item_list" => array(
            array(
                "keycustomer_name" => "John Doe",
                "keycustomer_phone" => "1234567890",
                "keycomments" => "Urgent delivery",
                "keypickup_address" => "29a Batumi Street, Tbilisi, Georgia",
                "keydropoff_address" => "Dighomi Massive, Tbilisi, Georgia"
            )
        )
    ))
);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, $curl_post_data);
$curl_response = curl_exec($curl);
curl_close($curl);
echo $curl_response;

Response Codes:

Code Description
200 Booking created successfully.
400 Booking creation failed.

2. Tracking API

API Endpoint: https://deliverers.ge/app/client_api/v2/track_barcode

Method: POST

Description: This API is used to track the booking using a barcode.

Request Parameters:

Parameter Type Description Example
keybarcode_no String The barcode number to track. QR1234567890
keyemail String The client's email address. example@mail.com

Sample Request:


    $service_url = 'https://deliverers.ge/app/client_api/v2/track_barcode';
    $curl = curl_init($service_url);
    $curl_post_data = array(
        'keybarcode_no' => 'QR1234567890',
        'keyemail' => 'example@mail.com'
    );
    curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($curl, CURLOPT_POST, true);
    curl_setopt($curl, CURLOPT_POSTFIELDS, $curl_post_data);
    $curl_response = curl_exec($curl);
    curl_close($curl);
    echo $curl_response;