Kullanıcı Gönderici Adresleri

GET /v1/addresses/sender/{USER_ID}

Detaylı Açıklama

GET /v1/addresses/sender/{USER_ID}

Kullanıcıya ait sadece 'Gönderici' (sender) tipindeki fiziki adresleri listeler.

Parametreler

Parametre	Konum	Tip	Açıklama	Varsayılan	Örnek
Authorization *	header	string	Bearer Yetkilendirme Tokeni (Örn: Bearer eyJhb...)	-	Bearer <TOKEN>
search *	query	string	Sonuçları spesifik bir isme veya dizeye göre filtreler.	-	Evim
limit *	query	string	Bir sayfada çekilecek maksimum kayıt sayısı. (Örn: 20 veya 50)	-	1
offset *	query	string	Sayfalama (Pagination) için atlanacak kayıt sayısı. Varsayılan 0.	-	0
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/addresses/sender/{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/addresses/sender/{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": "Tip ile kullanıcının adresleri getirildi.",
  "payload": {
    "data": [
      {
        "others": {
          "tag": null,
          "latitude": null,
          "longitude": null,
          "isActive": false,
          "updated": "2026-02-23T20:16:31.969Z",
          "created": "2026-02-23T20:16:31.969Z"
        },
        "_id": "699cb59fe3825f13041529b2",
        "type": "sender",
        "title": "Xristal",
        "explanation": null,
        "location": {
          "country": {
            "id": "298795",
            "title": "Türkiye",
            "code": "tr"
          },
          "province": {
            "id": null,
            "title": null,
            "code": null
          },
          "city": {
            "id": "55",
            "title": "Samsun",
            "code": null
          },
          "district": {
            "id": "55015",
            "title": "Atakum",
            "code": null
          },
          "neighborhood": {
            "id": null,
            "title": null,
            "code": null
          },
          "street": {
            "id": null,
            "title": null,
            "code": null
          },
          "address": {
            "line1": "Samsun Teknopark",
            "line2": null,
            "line3": null
          },
          "postCode": null
        },
        "by": {
          "phone1": {
            "phoneCountryCode": "90",
            "number": "3624575656"
          },
          "phone2": {
            "phoneCountryCode": null,
            "number": null
          },
          "phone3": {
            "phoneCountryCode": null,
            "number": null
          },
          "entity": "Xristal",
          "email": null
        },
        "__v": 0
      }
    ],
    "totalCount": 1
  },
  "code": 500
}

401: Yetkisiz

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