Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Zasób Points
reprezentuje lokalizacje, w których dostępne są usługi operatorów logistycznych. Punktami mogą być maszyny samoobsługowe (Paczkomat®) lub oddziały, punkty obsługi klienta. Każda z lokalizacji oferuje określone usługi - lista tych usług zwracana jest w odpowiedzi pod atrybutem functions.
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Nowe środowiska z autoryzacją Środowisko produkcyjne: https://api.inpost.pl/v1/points Generowanie dostępu
Środowisko testowe: Generowanie dostępu
|
Info |
---|
Więcej informacji o dostępnych sposobach prezentacji punktów odbioru Prezentowanie punktów odbioru |
Na tej stronie
Table of Contents |
---|
Struktura
Zasób Point
posiada następujące atrybuty:
Atrybut | Typ | Opis | |||
---|---|---|---|---|---|
| String | ID punktu. Jest to jego unikalna nazwa, np. KRA007 (Dla Paczkomat®) | |||
| Array | Tablica określająca jakie rodzaje punktów mieszczą się w danej lokalizacji. Możliwe typy punktów:
| |||
| String | Status punktu. (Operating, NonOperating, Disabled) | |||
| Object | Obiekt Przykład obiektu
| |||
| String | Typ lokalizacji. | |||
| String | Informacje dodatkowe o lokalizacji punktu, które mogą ułatwić dotarcie do niego. | |||
| String | Dodatkowy opis. | |||
| String | Dodatkowy opis. | |||
| Integer | Odległość od punktu relatywnego podanego w wyszukiwaniu. Jeśli punkt relatywny nie został podany, wtedy przyjmuje wartość | |||
| String | Godziny otwarcia punktu. | |||
| Object | Obiekt Przykład obiektu
| |||
| Object | Dokładne dane adresowe punktu:
| |||
| String | Numer telefonu punktu. | |||
| String | Informacje dodatkowe o punkcie. | |||
| Array | Tablica określające jakie funkcje posiada punkt. Możliwe funkcje: | |||
Identyfikator | Opis funkcji | ||||
| Send and collect standard parcel | ||||
| Standard parcel send | ||||
| Standard parcel collect | ||||
| Standard parcel reverse return to sender | ||||
| Standard letter collect | ||||
| Standard letter send | ||||
| Allegro parcel collect | ||||
| Allegro parcel send | ||||
| Allegro parcel return to sender | ||||
| Allegro letter collect | ||||
| Allegro letter send | ||||
| Allegro letter return to sender | ||||
| Allegro courier parcel collect | ||||
| Allegro courier parcel send | ||||
| Allegro courier parcel return to sender | ||||
| Courier parcel collect | ||||
| Courier parcel send | ||||
| Courier parcel return to sender | ||||
| Send and collect baggage from machine on airport | ||||
| Send and collect baggage from machine outside of airport | ||||
| Reservation collect from cooling machine | ||||
| Send and collect laundry | ||||
| Avizo collect | ||||
| Integer | ID partnera.
| |||
| Boolean | Czy jest to Paczkomat® typu NEXT. | |||
| Boolean | Dostępność płatności w danym punkcie. Istnieje możliwość wystąpienia payment_available=true razem z payment_type=0, oznacza to, że płatność jest dostępna. | |||
| String | virtual. | |||
| Integer | Wirtualność punktu. | |||
| Array | Rekomendowane inne punkty w pobliżu. | |||
| Boolean | Czy Paczkomat® dostępny jest 24/7 (Paczkomat® z parametrem ustawionym na | |||
| Boolean | Czy Paczkomat® posiada strefę ułatwionego dostępu. | |||
| String | Typ Paczkomat® | |||
| String | Opis typu Paczkomat® |
Przykład zasobu Point
w formacie JSON:
Code Block | ||
---|---|---|
| ||
{ "href": "https://api-pl-points.easypack24.net/v1/points/KRA02APP", "name": "KRA02APP", "type": [ "parcel_locker" ], "status": "Operating", "location": { "longitude": 19.87325, "latitude": 50.00919 }, "location_type": "Outdoor", "location_date": null, "location_description": "Prywatna posesja wjazd od strony Dobrowolskiego", "location_description_1": null, "location_description_2": null, "distance": null, "opening_hours": "24/7", "address": { "line1": "Dobrowolskiego", "line2": "30-394 Kraków" }, "address_details": { "city": "Kraków", "province": "małopolskie", "post_code": "30-394", "street": "Dobrowolskiego", "building_number": null, "flat_number": null }, "phone_number": null, "payment_point_descr": "Płatność apką InPost oraz PayByLink", "functions": [ "allegro_courier_collect", "allegro_courier_reverse_return_send", "allegro_courier_send", "allegro_letter_reverse_return_send", "allegro_letter_send", "allegro_parcel_collect", "allegro_parcel_reverse_return_send", "allegro_parcel_send", "parcel", "parcel_collect", "parcel_reverse_return_send", "parcel_send", "standard_courier_reverse_return_send", "standard_courier_send" ], "partner_id": 0, "is_next": false, "payment_available": true, "payment_type": { "0": "Payments are not supported" }, "virtual": "0", "recommended_low_interest_box_machines_list": [ "KRA106M", "KRA20M", "KRA208M", "KRA197M", "KRA356M" ], "apm_doubled": null, "location_247": true, "operating_hours_extended": { "customer": null }, "agency": "IPM9988771", "image_url": "https://static.easypack24.net/points/pl/images/KRA02APP.jpg", "easy_access_zone": true, "air_index_level": "GOOD", "physical_type_mapped": "006", "physical_type_description": "Appkomat InPost – swoją paczkę odbierzesz wygodniej z aplikacją InPost" } |
Lista punktów
Pobieranie listy punktów. Kolekcja wspiera stronicowanie, które opisane jest na stronie Informacje ogólne.
|
Przykład zapytania
|
Odpowiedź
|
Szczegóły punktu
Pobieranie szczegółów punktu.
|
Przykład zapytania
| |||||
Odpowiedź
|
Kryteria wyszukiwania
Parametr | Typ | Opis | Przykład |
---|---|---|---|
| String | Wyszukuje punkt o podanej nazwie. |
|
| String | Wyszukuje punkty o podanym typie |
|
| String | Wyszukuje punkty posiadające podaną funkcję. |
|
| Integer | Wyszukuje punkty o podanym partner_id. |
|
| Boolean | Wyszukuje punkty, które są typu NEXT |
|
| Boolean | Filtrowanie listy punktów po dostępności płatności dla punktu. |
|
| String | Wyszukuje punkty, które posiadają podany kod pocztowy. |
|
| String | Wyszukuje punkty, które posiadają podane miasto. |
|
| String | Wyszukuje punkty, które posiadają podane województwo. |
|
| Integer | Wyszukuje punkty o podanej wirtualności. |
|
| Date | Wyszukiwanie punktów wg daty, po której nastąpiła aktualizacja punktu. Jeśli parametr |
|
| Date | Wyszukiwanie punktów wg daty, do której nastąpiła aktualizacja punktu. Wymaga podania |
|
| Boolean | Wyszukiwanie punktów które są dostępne 24/7. (Paczkomat® z parametrem ustawionym na |
|
Wyszukiwanie wg. lokalizacji
| String | Wyszukuje punkty położone najbliżej podanych współrzędnych geograficznych. |
|
| String | Wyszukuje punkty położone najbliżej podanego kodu pocztowego. |
|
| Double | Określa odległość w metrach od podanego w Użycie parametru wymusza sortowanie wg odległości. Domyślna wartość: 10000 (10km) |
|
| Integer | Limit zwracanych punktów w przypadku użycia parametrów w relative_point lub relative_post_code. |
|
Sortowanie wyników
| Sortowanie po nazwie punktów. |
|
| Sortowanie wg. odległości od punktu relatywnego ( |
|
| Sortowanie wg. statusu |
|
Sortowanie może odbywać się w dwóch kierunkach, poprzez użycie parametru sort_order.
Domyślnie wyniki sortowane są rosnąco (asc
) wg nazwy punktów(name).
| Sortuje punkty rosnąco |
|
| Sortuje punkty malejąco |
|
Stronicowanie
| Określa stronę wyników, która powinna zostać zwrócona. |
|
| Określa liczbę wyników wyświetlanych na stronie. Domyślna wartość: 25 |
|
Filtrowanie wyświetlanych pól
| Określa listę atrybutów punktu, która ma zostać wyświetlona na stronie. |
|