Kullanıcı Gönderilerini Listele
Açıklama
Section titled “Açıklama” GET
/v1/shipments/0 Kullanıcı hesabına ait tüm oluşturulmuş, iptal edilmiş veya teslim edilmiş kargoları listeler.
Parametreler
Section titled “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
Section titled “Örnek Kod”fetch('https://api.kargomucuz.com/v1/shipments/0', { method: 'GET', headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer <YOUR_TOKEN>' }}).then(response => response.json()).then(data => console.log(data));$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.kargomucuz.com/v1/shipments/0');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
Section titled “Yanıtlar”200: Başarılı kimlik doğrulaması sonrası dönen yanıt.
{ "status": true, "message": "Kullanıcı kargoları getirildi.", "payload": { "data": [ { "shipmentInfo": { "labelBase64": null, "senderAddressId": null, "receiverAddressId": null, "provider": { "entity": "ptt", "id": "6712f0820c3b87b34ff3cb33", "serviceCode": "ptt_fixed_price" }, "status": "delivered", "agreementNumber": "905834121", "folderReferenceCode": "folder-reference-code", "shipmentReferenceCode": "referance-code", "handlerTrackingLink": "https://pttws.ptt.gov.tr/Gonderi_Sorgu/faces/index.xhtml?id", "handlerTraces": [ { "IKODU": "1", "IMERK": "YENİŞEHİR/GÜVENEVLER", "ISAAT": "11:29:13", "ISLEM": "Kabul Edildi", "ITARIH": "30/12/2024", "siraNo": 1 }, { "IKODU": "3", "IMERK": "YENİŞEHİR/GÜVENEVLER", "ISAAT": "11:30:31", "ISLEM": "Torbaya Eklendi", "ITARIH": "30/12/2024", "siraNo": 2 }, { "IKODU": "11", "IMERK": "ADANA PKİM/ADANA PKİM", "ISAAT": "22:18:40", "ISLEM": "Gönderinin Geliş Kaydı Yapıldı", "ITARIH": "30/12/2024", "siraNo": 3 }, { "IKODU": "3", "IMERK": "ADANA PKİM/ADANA PKİM", "ISAAT": "22:53:33", "ISLEM": "Torbaya Eklendi", "ITARIH": "30/12/2024", "siraNo": 4 }, { "IKODU": "3", "IMERK": "SAMSUN 75. YIL PKİDM/SAMSUN 75. YIL PKİDM", "ISAAT": "11:53:56", "ISLEM": "Torbaya Eklendi", "ITARIH": "01/01/2025", "siraNo": 5 }, { "IKODU": "11", "IMERK": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "ISAAT": "09:26:12", "ISLEM": "Gönderinin Geliş Kaydı Yapıldı", "ITARIH": "02/01/2025", "siraNo": 6 }, { "IKODU": "7", "IMERK": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "ISAAT": "09:41:34", "ISLEM": "Dağıtıcıya Verildi", "ITARIH": "03/01/2025", "siraNo": 7 }, { "IKODU": "100", "IMERK": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "ISAAT": "13:22:05", "ISLEM": "Teslim Edildi", "ITARIH": "03/01/2025", "siraNo": 8 } ], "buyerPayShipping": false, "buyerPayProduct": false, "senderAddress": { "location": { "country": { "id": "298795", "title": "türkiye", "code": "tr" }, "province": { "id": null, "title": null, "code": null }, "city": { "id": null, "title": "mersin", "code": null }, "district": { "id": null, "title": "yenişehir", "code": null }, "neighborhood": { "id": null, "title": null, "code": null }, "street": { "id": null, "title": null, "code": null }, "address": { "line1": "Some Address", "line2": null, "line3": null }, "postCode": null }, "by": { "phone1": { "phoneCountryCode": "90", "number": "1234567890" }, "phone2": { "phoneCountryCode": null, "number": null }, "phone3": { "phoneCountryCode": null, "number": null }, "entity": "Name", "email": null } }, "receiverAddress": { "location": { "country": { "id": "298795", "title": "türkiye", "code": "tr" }, "province": { "id": null, "title": null, "code": null }, "city": { "id": null, "title": "samsun", "code": null }, "district": { "id": null, "title": "atakum", "code": null }, "neighborhood": { "id": null, "title": null, "code": null }, "street": { "id": null, "title": null, "code": null }, "address": { "line1": "Some Address", "line2": null, "line3": null }, "postCode": null }, "by": { "phone1": { "phoneCountryCode": "90", "number": "1234567890" }, "phone2": { "phoneCountryCode": null, "number": null }, "phone3": { "phoneCountryCode": null, "number": null }, "entity": "Name Surname", "email": null } }, "packageInfo": { "width": 0.01, "height": 0.01, "depth": 0.01, "weight": 1, "desiOrKg": 1, "itemsAmountCurrency": null, "itemsTaxAmount": 0, "itemsAmount": 0, "items": [] }, "barcode": "BARCODE", "traces": [ { "status": "accepted", "description": "YENİŞEHİR/GÜVENEVLER", "created": "2024-12-30T11:29:13Z" }, { "status": "unknown", "description": null, "created": "2024-12-30T09:00:10.341Z" }, { "status": "unknown", "description": null, "created": "2024-12-30T20:00:09.234Z" }, { "status": "unknown", "description": null, "created": "2025-01-01T11:00:09.004Z" }, { "status": "transit_hub", "description": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "created": "2025-01-02T09:26:12Z" }, { "status": "in_distribution", "description": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "created": "2025-01-03T09:41:34Z" }, { "status": "delivered", "description": "SAMSUN 75. YIL PKİDM/ATAKUM DAĞ.ŞEF.", "created": "2025-01-03T13:22:05Z" } ], "lastStatusCheckDate": "2025-01-03T13:00:09.815Z", "handlerDesiOrKg": 1, "handlerShippedTime": "2024-12-30T11:29:13.000Z", "handlerDeliveredTime": "2025-01-03T13:22:05.000Z" }, "paymentInfo": { "paymentAmountCurrency": "try", "paymentAmount": 5, "totalPaymentAmount": 5, "extraPaymentId": null, "extraPaymentAmountCurrency": null, "extraPaymentAmount": null, "extraPayments": [], "returnedPayments": [] }, "others": { "discountAmount": 0, "couponCode": null, "invoiceUuid": null, "invoiceDate": null, "deleted": false, "codPaymentStatus": null, "codAdminConfirmation": false, "codPaymentDate": null, "invoiced": false, "returned": false, "canceled": false, "updated": "2024-12-29T19:24:56.906Z", "created": "2024-12-29T19:24:56.906Z" }, "resellerId": null, "_id": "6771a208733904c563373c53", "title": null, "explanation": null, "__v": 0, "labelData": { "instructionHTML": "<p>Bu gönderi E-ticaret kabul ekranından <b>Kargomucuz.com</b>'ten kabul edilecektir. İşbirliğiniz için teşekkürler!</p>", "barcodeValue": "KU5901PT0075SA", "logoURI": "https://upload.wikimedia.org/wikipedia/tr/a/a7/Ptt_yenilogo.png" } } ], "totalCount": 153 }, "code": 500}