Kullanıcı Gönderilerini Listele

GET /v1/shipments/{USER_ID}

Detaylı Açıklama

GET /v1/shipments/{USER_ID}

Kullanıcı hesabına ait tüm oluşturulmuş, iptal edilmiş veya teslim edilmiş kargoları listeler.

Parametreler

Parametre	Konum	Tip	Açıklama	Varsayılan	Örnek
Authorization *	header	string	Bearer Yetkilendirme Tokeni (Örn: Bearer eyJhb...)	-	Bearer <TOKEN>
start-date	query	string		-	2025-05-01T00:00:00+03:00
end-date	query	string		-	2025-05-08T23:00:00+03:00
shipment-status	query	string		-	true
shipment-status	query	string		-	shipmentsDeliveredCount
search	query	string	Sonuçları spesifik bir isme veya dizeye göre filtreler.	-	teknopark
USER_ID *	path	string	İşlem yapan kullanıcının kimlik (ID) değeri. UUID formatındadır.	-	-

Örnek Kod

Node.js

fetch('https://api.kargomucuz.com/v1/shipments/{USER_ID}', {
  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/{USER_ID}');
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": "Kullanıcı kargoları getirildi.",
  "payload": {
    "data": [],
    "totalCount": 0
  },
  "code": 500
}

401: Yetkisiz

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