Kargo Sağlayıcıları

GET /v1/shipments/providers

Detaylı Açıklama

GET /v1/shipments/providers

Sisteme entegre tüm aktif kargo firmalarının detaylı bilgilerini döner.

Parametreler

Parametre	Konum	Tip	Açıklama	Varsayılan	Örnek
Authorization *	header	string	Bearer Yetkilendirme Tokeni (Örn: Bearer eyJhb...)	-	Bearer <TOKEN>
feature-codes *	query	string		-	-
type	query	string		-	standart

Örnek Kod

Node.js

fetch('https://api.kargomucuz.com/v1/shipments/providers', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer <YOUR_TOKEN>'
  }
})
.then(response => response.json())
.then(data => console.log(data));

PHP

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.kargomucuz.com/v1/shipments/providers');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$headers = array();
$headers[] = 'Content-Type: application/json';
$headers[] = 'Authorization: Bearer <YOUR_TOKEN>';
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close($ch);
echo $result;

Yanıtlar

200: Başarılı

{
  "status": true,
  "message": "Kargo servis sağlayıcılar getirildi.",
  "payload": {
    "data": [
      {
        "others": {
          "updated": "2024-10-18T23:34:26.883Z",
          "created": "2024-10-18T23:34:26.883Z"
        },
        "_id": "6712f0820c3b87b34ff3cb33",
        "private": false,
        "providerEntity": "ptt",
        "providerType": "fixed_price",
        "providerServiceCode": "ptt_fixed_price",
        "title": "PTT Sabit Fiyatlı Kargo",
        "maxDesiNumber": 31,
        "addedAmountAfterMaxDesiOrKg": 10,
        "currency": "try",
        "imageUrl": "https://upload.wikimedia.org/wikipedia/tr/a/a7/Ptt_yenilogo.png",
        "__v": 0,
        "featureCodes": [
          101,
          102
        ],
        "addedAmountAfterReturnedShipment": 0,
        "addedPercentageAfterReturnedShipment": 0
      },
      {
        "others": {
          "updated": "2025-08-18T21:30:31.693Z",
          "created": "2025-08-18T21:30:31.693Z"
        },
        "_id": "68a39b77ef4188b3428d3336",
        "private": false,
        "providerServiceCode": "ptt_standart_2",
        "providerEntity": "ptt",
        "providerType": "standart",
        "title": "PTT Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 30,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://upload.wikimedia.org/wikipedia/tr/a/a7/Ptt_yenilogo.png",
        "featureCodes": [
          102
        ],
        "__v": 0
      },
      {
        "others": {
          "updated": "2025-08-18T21:33:01.748Z",
          "created": "2025-08-18T21:33:01.749Z"
        },
        "_id": "68a39c0def4188b3428d3400",
        "private": false,
        "providerServiceCode": "hepsijet_standart_2",
        "providerEntity": "hepsijet",
        "providerType": "standart",
        "title": "Hepsijet Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 10,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTsZZ8o8QCRj_B86iBRaKakZ-7miB512Q4x2A&s",
        "featureCodes": [],
        "__v": 0
      },
      {
        "others": {
          "updated": "2025-08-18T21:34:16.221Z",
          "created": "2025-08-18T21:34:16.221Z"
        },
        "_id": "68a39c58ef4188b3428d3412",
        "private": false,
        "providerServiceCode": "surat_standart_2",
        "providerEntity": "surat",
        "providerType": "standart",
        "title": "Surat Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 24,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://www.suratkargo.com.tr/assets/images/logo.png",
        "featureCodes": [
          102
        ],
        "__v": 0
      },
      {
        "others": {
          "updated": "2025-09-03T19:52:16.337Z",
          "created": "2025-09-03T19:52:16.337Z"
        },
        "_id": "68b89c70c8dd9346ae2799ce",
        "private": false,
        "providerServiceCode": "ups_standart_2",
        "providerEntity": "ups",
        "providerType": "standart",
        "title": "UPS Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 20,
        "addedPercentageAfterReturnedShipment": 55,
        "currency": "try",
        "imageUrl": "https://w7.pngwing.com/pngs/487/604/png-transparent-united-parcel-service-logo-the-ups-store-cargo-mail-business-label-text-trademark.png",
        "featureCodes": [],
        "__v": 0
      },
      {
        "others": {
          "updated": "2026-02-06T12:16:49.965Z",
          "created": "2026-02-06T12:16:49.966Z"
        },
        "_id": "6985dbb1a4a45a36f5be229e",
        "private": false,
        "providerServiceCode": "kolaygelsin_standart_2",
        "providerEntity": "kolaygelsin",
        "providerType": "standart",
        "title": "KOLAYGELSİN Standart Kargo 2",
        "maxDesiNumber": 30,
        "addedAmountAfterMaxDesiOrKg": 26,
        "addedPercentageAfterReturnedShipment": 40,
        "currency": "try",
        "imageUrl": "https://developer.kolaygelsin.com/logo.0f38437e8c3363c5a580.png",
        "featureCodes": [],
        "__v": 0
      }
    ],
    "totalCount": 6
  },
  "code": 500
}

401: Yetkisiz

{
  "status": false,
  "message": "Herhangi bir giriş sağlanmadı.",
  "code": 500
}