[1.2.0] Wyszukiwanie szablonów przesyłek

Wyszukiwanie szablonów przesyłek API X odbywa się poprzez podanie jednego lub więcej z poniższych kryteriów jako parametr w zapytaniu GET wykonanym na adres URI kolekcji szablonów przesyłek:

  • /v1/organizations/:organization_id/shipment_templates

Przykładowe zapytanie

curl https://api-shipx-pl.easypack24.net/v1/organizations/1/shipment_templates?name=template_1 -H "Authorization: Bearer ..."

Kryteria wyszukiwania

ParametrTypDziałaniePrzykład
nameString

Wyszukuje szablony, których nazwa zawiera wskazany ciąg.

?name=mag
statusStringWyszukuje szablony, których status zawiera wskazany ciąg.?status=suspended

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

 Wartość sort_byDziałaniePrzykład
idSortuje szablony po identyfikatorze.?sort_by=id
nameSortuje szablony po nazwie.?sort_by=name
statusSortuje szablony po statusie.?sort_by=status
created_atSortuje szablony po dacie utworzenia.?sort_by=created_at
updated_atSortuje szablony po dacie edycji.?sort_by=updated_at

Sortowanie może odbywać się w dwóch kierunkach, poprzez użycie parametru sort_order:

Wartość sort_orderDziałaniePrzykład
ascSortuje zlecenia odbioru rosnąco?sort_order=asc&sort_by=id
descSortuje zlecenia odbioru malejąco?sort_order=desc&sort_by=id

Domyślnie wyniki sortowane są malejąco (desc) wg daty utworzenia punktu odbioru (created_at).