Struktura
Zasób Tracking
posiada następujące atrybuty:
Atrybut | Typ | Opis | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| String | Numer przesyłki | ||||||||||||||||||
| String | Rodzaj przesyłki. Dostępne rodzaje opisane są na stronie Rozmiary i usługi dla przesyłek | ||||||||||||||||||
| String | Rodzaj przesyłki. Dostępne rodzaje opisane są na stronie Rozmiary i usługi dla przesyłek | ||||||||||||||||||
| Object | Dodatkowe atrybuty dla przesyłek paczkomatowych.
| ||||||||||||||||||
| String | Status w jakim aktualnie znajduje się przesyłka. | ||||||||||||||||||
| DateTime | Data utworzenia przesyłki. | ||||||||||||||||||
| DateTime | Data ostatniej aktualizacji informacji o zmianie statusu. | ||||||||||||||||||
| Array | Tablica obiektów zawierające historię zmian statusów, posortowana chronologicznie w kolejności malejącej (ostatni status jest pierwszy na liście).
| ||||||||||||||||||
| Array | Tablica przewidywanych statusów, przez które może przejść jeszcze określona przesyłka. |
Przykład zasobu Tracker
w formacie JSON:
Code Block | ||
---|---|---|
| ||
{
"tracking_number": "612345678901234567890123",
"type": "inpost_locker_standard",
"service": "inpost_locker_standard",
"status": "dispatched_by_sender",
"custom_attributes": {
"size": "A"
"target_point_id": "KRA000",
"target_machine_detail": {
"href": "https://api-pl-points.easypack24.net/v1/points/AAA000",
"name": "AAA000",
"opening_hours": "PN-PT 09:00-16:00",
"location_description": "Beta Agencja Usługowo-Finansowa",
"location": {
"latitude": 50.26899,
"longitude": 18.97812
},
"address": {
"line1": "ul.Reymonta 999",
"line2": "33-333 Kraków"
},
"type": [
"parcel_locker"
]
},
},
"tracking_details": [
{
"status": "dispatched_by_sender",
"origin_status": "NWP",
"agency": "Kraków",
"datetime": "2015-09-17T11:28:00.000+02:00"
},
{
"status": "confirmed",
"origin_status": "PPN",
"agency": null,
"datetime": "2015-09-17T10:28:00.000+02:00"
}
],
"expected_flow": [],
"created_at": "2015-09-17T08:00:00.000+02:00",
"updated_at": "2015-09-17T11:28:00.000+02:00",
} |
Code Block |
---|
określ rodzaj zapytania i ścieżkę do funkcjonalności, np.
GET /v1/machines |
Parametry
Przykład zapytania
Code Block |
---|
GET W_TYM_MIEJSCU_WSTAW_SCIEZKE_DO_FUNKCJI HTTP/1.1
Host: api-shipx-pl.easypack24.net
Content-Type: application/json
Authorization: Bearer lkfjasd9f70y43ohriw...[ommited for brevity]...
Jeśli zasób wywoływany jest metodą POST, umieść tutaj przykład przesyłanych danych w odpowiednim formacie (najczęściej JSON). |
Odpowiedź
Uwierzytelnianie
Zasób Tracking nie jest autoryzowany, nie jest wymagane podanie tokenu.
Flow przesyłek (wygaszone)
Dla każdego z rodzajów przesyłek może występować różne, spodziewane flow (expected_flow
).
Pobieranie flow dla określonego rodzaju przesyłki
Code Block |
---|
/v1/tracking/flow/:shipment_type |
Tip |
---|
Możliwe wartości dla parametru |
Przykład zapytania
Przykład odpowiedzi