Basit Kargo API- Tek API Tüm Kargo Firmaları

Yetkilendirme

Basit Kargo API'lerini kullanmak için, öncelikle panelden giriş yaparak ayarlar sayfasından API Token üretmeniz gerekiyor. İsteklerinizde "Authorization" başlığı içinde "Bearer" tokeni olarak belirtmeniz gerekmektedir.

Örnek:

                                                        
Authorization: Bearer {token}

Aktif Kargo Firmalarını Listeleme

Aktif kargo firmalarının listesini görüntülemek için, bu servisi kullanabilirsiniz.

Method: GET URL: https://basitkargo.com/api/handlers

Servis örnek Cevap

                                                            
[
    {
      "name": "Aras Kargo",
      "code": "ARAS",
      "logo": "https://cdn.basitkargo.com/logo/aras.png"
    },
    {
      "name": "Yurtiçi Kargo",
      "code": "YURTICI",
      "logo": "https://cdn.basitkargo.com/logo/yurtici.png"
    },
    {
      "name": "Aras Kargo - KA (Kendi Anlaşmam)",
      "code": "SELF_ARAS",
      "logo": "https://cdn.basitkargo.com/logo/aras.png"
    }
]

Kargo Durum Bilgileri

Servislerde durum ("status") bilgisi altında dönen parametrelerin açıklamaları:

                                                            
NEW: Yeni
READY_TO_SHIP: Gönderime Hazır
SHIPPED: Yolda
NEEDS_SUPPORT: Destek Gerekiyor (Sorunlu)
COMPLETED: Teslim Edildi
RETURNING: Geri Dönüyor
RETURNED: Geri Döndü
OUT_FOR_DELIVERY: Dağıtıma Çıkarıldı
DELAYED: Gecikmeli
LOST: Kayıp

Kargo Bilgisi Ekleme

Kargo bilgilerinizi eklemek ve daha sonra kargo kodu oluşturmak için, bu servisi kullanabilirsiniz.

Method: POST URL: https://basitkargo.com/api/v2/order

Servis Örnek İstek (Payload)

                                                            
{
  "content": {
    "name": "Test Sipariş",
    "code": "#123456",
    "items": [
      {
        "name": "Ürün Adı",
        "code": "STK32",
        "quantity": "1"
      }
    ],
    "packages": [
      {
        "height": 10,
        "width": 15,
        "depth": 5,
        "weight": 1
      }
    ]
  },
  "client": {
    "name": "Test Alıcı",
    "phone": "5555555555",
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah."
  },
  "collect": 100 // kapıda ödeme tutarı
}

Servis Örnek Cevap

                                                            
{
    "id": "888-6AR-OUP",
    "barcode": null,
    "type": "OUTGOING",
    "status": "NEW",
    "validationFailed": false,
    "validationFailedMessage": null,
    "createdTime": "2023-01-01T15:41:47.7553603",
    "updatedTime": "2023-01-01T15:41:47.7633629",
    "content": {
        "name": "Test Ürün",
        "code": "#123456",
        "packages": [
            {
                "height": 10,
                "width": 15,
                "depth": 5,
                "weight": 1,
                "kgDesi": 1
            }
        ],
        "totalDesiKg": 1
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Test Alıcı",
        "phone": "5555555555",
        "city": "İstanbul",
        "town": "Kadıköy",
        "address": "Koşuyolu Mah."
    },
    "shipmentInfo": {
        "handler": null,
        "handlerShipmentCode": null,
        "handlerShipmentTrackingLink": "",
        "handlerDesi": null,
        "lastState": null,
        "shippedTime": null,
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 0,
        "extraFee": null,
        "totalCost": 0
    },
    "traces": []
}

Kargo Bilgisi Ekleme Ve Kargo Kodu Alma

Kargo bilgilerinizi eklemek ve belirttiğiniz kargo firması için kargo kodu almak için bu servisi kullanabilirsiniz.

Method: POST URL: https://basitkargo.com/api/v2/order/barcode

Servis Örnek İstek (Payload)

                                                            
{
  "handlerCode": "SURAT",
  "content": {
    "name": "Test Sipariş",
    "code": "#123456",
    "items": [
      {
        "name": "Ürün Adı",
        "code": "STK32",
        "quantity": "1"
      }
    ],
    "packages": [
      {
        "height": 10,
        "width": 15,
        "depth": 5,
        "weight": 1
      }
    ]
  },
  "client": {
    "name": "Test Alıcı",
    "phone": "5555555555",
    "city": "İstanbul",
    "town": "Kadıköy",
    "address": "Koşuyolu Mah."
  }
}

Servis Örnek Cevap

                                                            
{
    "id": "999-UA7-DEI",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "READY_TO_SHIP",
    "validationFailed": false,
    "validationFailedMessage": null,
    "createdTime": "2023-02-01T15:52:14.0849441",
    "updatedTime": "2023-02-01T15:52:14.1609697",
    "content": {
        "name": "Test Ürün",
        "code": "#123456",
        "packages": [
            {
                "height": 10,
                "width": 15,
                "depth": 5,
                "weight": 1,
                "kgDesi": 1
            }
        ],
        "totalDesiKg": 1
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Test Alıcı",
        "phone": "5555555555",
        "city": "İstanbul",
        "town": "Kadıköy",
        "address": "Koşuyolu Mah."
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": null,
        "handlerShipmentTrackingLink": "",
        "handlerDesi": null,
        "lastState": null,
        "shippedTime": null,
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 41.99,
        "extraFee": null,
        "totalCost": 41.99
    },
    "traces": []
}

Kargo Bilgisi Sorgulama (ID ile)

Bu servisi kullanarak kargo id ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/{id}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Bilgisi Sorgulama (Barkod No ile)

Bu servisi kullanarak barkod no ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/barcode/{barkod}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Bilgisi Sorgulama (Kargo Firması Takip No ile)

Bu servisi kullanarak kargo firması takip no ile kargo bilgilerini getirebilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/handler-shipment-code/{code}

Servis Örnek Cevap

                                                            
{
    "id": "101-DM2-XYD",
    "barcode": "1234567890",
    "type": "OUTGOING",
    "status": "COMPLETED",
    "validationFailed": false,
    "validationFailedMessage": "",
    "createdTime": "2022-07-28T20:01:21",
    "updatedTime": "2022-08-14T18:12:24",
    "content": {
        "name": "Ekran Kartı",
        "code": "#123456",
        "packages": [
            {
                "height": 25,
                "width": 10,
                "depth": 20,
                "weight": 1,
                "kgDesi": 2
            }
        ],
        "totalDesiKg": 2.00
    },
    "sender": {
        "name": "Gönderici Adı",
        "phone": "4444444444"
    },
    "recipient": {
        "name": "Alıcı Adı",
        "phone": "5555555555",
        "city": "Yalova",
        "town": "Merkez",
        "address": "açık adres"
    },
    "shipmentInfo": {
        "handler": {
            "name": "MNG Kargo",
            "code": "MNG",
            "logo": "mng.png"
        },
        "handlerShipmentCode": "1234567890",
        "handlerShipmentTrackingLink": "https://kargotakip.mngkargo.com.tr/?takipNo=1234567890",
        "handlerDesi": 5.00,
        "lastState": "Teslim Edildi",
        "shippedTime": "2022-07-28T20:01:21",
        "deliveredTime": null
    },
    "priceInfo": {
        "paymentMethod": "ADVANCE",
        "shipmentFee": 29.93,
        "extraFee": null,
        "totalCost": 29.93
    },
    "traces": [
        {
            "status": "Teslim Edildi",
            "time": "2022-08-17T18:10:10",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Adresinize Yönlendirildi",
            "time": "2022-08-17T12:37:35",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Gönderi Varış Birimine Ulaştı",
            "time": "2022-08-17T09:46:43",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T09:46:42",
            "location": "YALOVA (MERKEZ)",
            "locationDetail": "MİMOZA Şube"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-17T01:47:28",
            "location": "BURSA",
            "locationDetail": "BURSA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T21:07:04",
            "location": "İSTANBUL",
            "locationDetail": "MARMARA AKTARMA"
        },
        {
            "status": "Transfer Aşamasında",
            "time": "2022-08-16T15:14:19",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        },
        {
            "status": "Gönderi Hazırlandı",
            "time": "2022-08-16T09:53:09",
            "location": "İSTANBUL (KADIKÖY)",
            "locationDetail": "HASANPAŞA Şube"
        }
    ]
}

Kargo Barkod İptal Etme (Barkod No ile)

Bu servisi kullanarak kargo şubesine teslim edilmemiş kargoları iptal edebilirsiniz.

Method: DELETE URL: https://basitkargo.com/api/order/barcode/{barkod}

İade Kodu Oluşturma (Barkod numarası ile)

Bu servisi kullanarak teslim edilmiş kargolarınız için iade kodu alabilirsiniz.

Method: GET URL: https://basitkargo.com/api/v2/order/return/barcode/{barcode}

Desi/Kg Bilgisi İle Fiyat Listeleme

Bu servis ile desi/kg bilgisi kullanarak fiyat bilgilerini listeleyebilirsiniz.

Method: GET URL: https://basitkargo.com/api/handlers/fee/desiKg/5

Servis örnek Cevap

                                                            
[
    {
        "desiKg": 5,
        "handlerCode": "MNG",
        "price": 25.54
    },
    {
        "desiKg": 5,
        "handlerCode": "YURTICI",
        "price": 25.54
    }
]

Paket Bilgileri İle Fiyat Listeleme

Bu servis ile kargo paket bilgilerini kullanarak fiyat bilgilerini listeleyebilirsiniz.

Method: POST URL: https://basitkargo.com/api/handlers/fee/packages

Servis Örnek İstek (Payload)

                                                            
[
    {
        "height": "10",
        "width": "15",
        "depth": "5",
        "weight": "1"
    }
]

Servis örnek Cevap

                                                            
[
    {
        "desiKg": 1,
        "handlerCode": "MNG",
        "price": 15.54
    },
    {
        "desiKg": 1,
        "handlerCode": "YURTICI",
        "price": 15.54
    }
]

Kullanıcı Bakiye Sorgulama

Bu servis ile bakiyenizi sorgulayabilirsiniz.

Method: GET URL: https://basitkargo.com/api/user/balance

Servis örnek Cevap

Şehir Listeleme

Bu servis ile şehir listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/country/90/cities

Servis örnek Cevap

                                                            
[
  {
    "id": 1,
    "name": "Adana"
  },
  {
    "id": 2,
    "name": "Adıyaman"
  },
  {
    "id": 3,
    "name": "Afyonkarahisar"
  },
  {
    "id": 4,
    "name": "Ağrı"
  }
]

İlçe Listeleme

Bu servis ile şehirlere ait ilçe listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/city/{id}/towns

Servis örnek Cevap

                                                            
[
  {
    "id": 1154,
    "name": "Atabey"
  },
  {
    "id": 1297,
    "name": "Eğirdir"
  },
  {
    "id": 1341,
    "name": "Gelendost"
  }
]

Köy/Mahalle Listeleme

Bu servis ile ilçelere ait köy/mahalle listesine ulaşabilirsiniz.

Method: GET URL: https://basitkargo.com/api/city/{cityName}/town/{townName}/neigborhoods Method: GET URL: https://basitkargo.com/api/city/Isparta/town/Yalvaç/neigborhoods

Servis örnek Cevap

                                                            
{
    "Terziler": [],
    "Dedeçam": [
        "Bahçelievler",
        "Orta",
        "Yeni"
    ],
    "Ayvalı": [],
    "Tokmacık": [
        "Bolatlık",
        "Esentepe",
        "Gökçay",
        "Gülkent",
        "Yayla",
        "Yeni"
    ],
    "Kırkbaş": [],
    "Mısırlı": [],
    "Bağlarbaşı": [
        "Tepecik",
        "Yukarı",
        "Yusuflar"
    ],
    "Aşağıkaşıkara": [
        "Aşağı Yukarı",
        "Dere Gültepe"
    ],
    "Eyüpler": [],
    "Celeptaş": [
        "Aşağı",
        "Yukarı"
    ],
    "Merkez": [
        "Abacılar",
        "Akköprü",
        "Bahçelievler",
        "Bağlar",
        "Cumhuriyet",
        "Debbağlar",
        "Eski",
        "Fatih",
        "Görgü Bayram",
        "Görgü Camii",
        "Görgüorta",
        "Kaşaşağı",
        "Kaşcami",
        "Kaşhacıbey",
        "Kaşyukarı",
        "Kızılca",
        "Kuşku",
        "Leblebiciler",
        "Müderris",
        "Pazar Aşağı",
        "Pazar Yukarı",
        "Salur",
        "Sanayi",
        "Saray",
        "Sofular",
        "Zafer",
        "Çarşı"
    ],
    "Akçaşar": [],
    "Çetince": [
        "Aşağı",
        "Cumhuriyet",
        "Karşıyaka",
        "Mithatpaşa",
        "Yeni",
        "Yukarı"
    ],
    "Koruyaka": [],
    "Bahtiyar": [],
    "Çamharman": [],
    "Yağcılar": [
        "Yeni"
    ],
    "Kuyucak": [
        "Harman",
        "Orta",
        "Yeni",
        "Yukarı"
    ],
    "Çakırçal": [],
    "Özbayat": [
        "Harman",
        "Kuzyaka",
        "Orta",
        "Yeni"
    ],
    "Eğirler": [],
    "Hisarardı": [],
    "Sağırköy": [
        "Aşağı",
        "Yukarı"
    ],
    "Altıkapı": [],
    "Aşağıtırtar": [
        "Gümüşlü",
        "İslibucağı",
        "Küçüktepe",
        "Mezarlık",
        "Tolyüzü"
    ],
    "Kozluçay": [
        "Ardıçlı",
        "Aşağı",
        "Dere",
        "Fatih",
        "Yayla",
        "Yeni",
        "Yukarı"
    ],
    "Hüyüklü": [
        "Eskigeçit",
        "Mescit",
        "Nalbant",
        "Yanarık",
        "Yeni"
    ],
    "Gökçeali": [],
    "Taşevi": [],
    "Sücüllü": [
        "Aşağı",
        "Deliktaş",
        "Harman",
        "Hurşitler",
        "Yeni",
        "Yukarı"
    ],
    "Özgüney": [
        "Fatih",
        "Pazar",
        "Selçuklu",
        "Yeni"
    ],
    "Yarıkkaya": [],
    "Yukarıtırtar": [],
    "Yukarıkaşıkara": [
        "Fatih",
        "Harman",
        "Yayla",
        "Yeni"
    ],
    "Kumdanlı": [
        "Aşağı",
        "Orta",
        "Yeni",
        "Yukarı",
        "Çayır"
    ],
    "Körküler": [
        "Aşağı",
        "Eski",
        "Pazar",
        "Yeni"
    ],
    "Bağkonak": [
        "Cumhuriyet",
        "Fatih",
        "Kale",
        "Ulucamii",
        "Yeni"
    ],
    "Kurusarı": [],
    "İleği": [
        "Yukarı"
    ]
}

Yetkilendirme

Örnek:

Aktif Kargo Firmalarını Listeleme

Servis örnek Cevap

Kargo Durum Bilgileri

Kargo Bilgisi Ekleme

Servis Örnek İstek (Payload)

Servis Örnek Cevap

Kargo Bilgisi Ekleme Ve Kargo Kodu Alma

Servis Örnek İstek (Payload)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (ID ile)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (Barkod No ile)

Servis Örnek Cevap

Kargo Bilgisi Sorgulama (Kargo Firması Takip No ile)

Servis Örnek Cevap

Kargo Barkod İptal Etme (Barkod No ile)

İade Kodu Oluşturma (Barkod numarası ile)

Desi/Kg Bilgisi İle Fiyat Listeleme

Servis örnek Cevap

Paket Bilgileri İle Fiyat Listeleme

Servis Örnek İstek (Payload)

Servis örnek Cevap

Kullanıcı Bakiye Sorgulama

Servis örnek Cevap

Şehir Listeleme

Servis örnek Cevap

İlçe Listeleme

Servis örnek Cevap

Köy/Mahalle Listeleme

Servis örnek Cevap

Başlıklar

Hakkımızda