Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Lista książek adresowych
Wyszukiwanie książek adresowych odbywa się poprzez podanie jednego lub więcej z poniższych kryteriów
|
Kryteria wyszukiwania
Parametr | Typ | Działanie | Przykład |
---|---|---|---|
| Integer Array | Wyszukuje książki adresowe o podanym id. Wyszukuje książki adresowe o podanych id. | ?id=12 ?id=12,17 |
| String | Wyszukuje książki adresowe, których nazwa zawiera wskazany ciąg. | ?name=mag |
| String | Wyszukuje książki adresowe, których imię zawiera wskazany ciąg. | ?first_name=jan |
| String | Wyszukuje książki adresowe, których nazwisko zawiera wskazany ciąg. | ?last_name=kowal |
| String Array | Wyszukuje książki adresowe, których adres e-mail jest identyczny jak wskazany ciąg. Wyszukuje książki adresowe ze wskazanymi adresami e-mail. | ?email=magazyn1@http://firma.com ,magazyn2@http://firma.com |
| String Array | Wyszukuje książki adresowe, których numer telefonu jest identyczny jak wskazany ciąg. Wyszukuje książki adresowe ze wskazanymi numerami telefonów. | ?phone=123123123 ?phone=123123123,1231231234 |
| Boolean | Wyszukuje książki adresowe, których nadawca przesyłek paczkomatowych Paczkomat® jest identyczny jak wskazany ciąg. | ?sender_parcel=true |
| Boolean | Wyszukuje książki adresowe, których nadawca przesyłek kurierskich jest identyczny jak wskazany ciąg. | ?sender_courier=true |
| Boolean | Wyszukuje książki adresowe, których nadawca przesyłek listowych jest identyczny jak wskazany ciąg. | ?sender_letter=true |
| String | Wyszukuje książki adresowe, których rodzaj jest nadawca (sender), albo odbiorca (receiver). | ?kind=sender |
| Date | Wyszukuje zlecenia odbioru utworzone w danym dniu. | ?created_at=2016-01-07 |
| Time | Wyszukuje zlecenia odbioru, których czas utworzenia jest >= wskazany czas. Czas może być podany w formacie ISO 8601 lub podobnym, a także jako timestamp. | ?created_at_gteq=2016-01-01T13:10+01:00 ?created_at_gteq=1451650200 |
| Time | Wyszukuje zlecenia odbioru, których czas utworzenia jest <= wskazany czas. Czas może być podany w formacie ISO 8601 lub podobnym, a także jako timestamp. | ?created_at_lteq=2016-01-01T13:10+01:00 ?created_at_lteq=1451650200 |
| String | Wyszukuje książki adresowe, w których pierwsza linia adresu głównego (street) zawiera wskazany ciąg. | ?main_address_street=Zaw |
| String | Wyszukuje książki adresowe, w których pierwsza linia adresu dostawy (street) zawiera wskazany ciąg. | ?delivery_address_street=Zaw |
| String | Wyszukuje książki adresowe, w których nazwa firmy zawiera wskazany ciąg. | ?company_name=TestCompanyName |
| String | Wyszukuje książki adresowe, w których preferowany punkt nadawczy zawiera wskazany ciąg. | ?preferred_dropoff_point=KRA120 |
Sortowanie wyników
Wyniki wyszukiwania można sortować przekazując parametr sort_by
, który może przyjmować następujące wartości:
Wartość sort_by | Działanie | Przykład |
---|---|---|
| Sortuje książki adresowe po identyfikatorze. | ?sort_by=id |
| Sortuje książki adresowe po nazwie. | ?sort_by=name |
| Sortuje książki adresowe po imieniu. | ?sort_by=first_name |
| Sortuje książki adresowe po nazwisku. | ?sort_by=last_name |
| Sortuje książki adresowe po adresie e-mail. | ?sort_by=email |
| Sortuje książki adresowe po numerze telefonu. | ?sort_by=phone |
| Sortuje książki adresowe po nadawcy przesyłek paczkomatowych.Paczkomat® | ?sort_by=sender_parcel |
| Sortuje książki adresowe po nadawcy przesyłek kurierskich. | ?sort_by=sender_courier |
| Sortuje książki adresowe po nadawcy przesyłek listowych. | ?sort_by=sender_letter |
| Sortuje książki adresowe po rodzaju. | ?sort_by=kind |
| Sortuje książki adresowe po dacie utworzenia. | ?sort_by=created_at |
| Sortuje książki adresowe po nazwie firmy. | ?sort_by=company_name |
| Sortuje książki adresowe po preferowanym punkcie nadawczym. | ?sort_by=preferred_dropoff_point |
Sortowanie może odbywać się w dwóch kierunkach, poprzez użycie parametru sort_order
. Domyślnie wyniki sortowane są malejąco (desc
) wg daty utworzenia punktu odbioru (created_at)
Wartość sort_order | Działanie | Przykład |
---|---|---|
| Sortuje punkty odbioru rosnąco. | ?sort_order=asc&sort_by=id |
| Sortuje punkty odbioru malejąco. | ?sort_order=desc&sort_by=id |
Przykładowe zapytanie
|
Odpowiedź
|