Structure
Points resource elements have the following attributes:
Description
href
The URI address to the resource of the particular point
Point ID. This is its unique name, e.g. KRA007 (for a Parcel Station)
type
Table specifying the kinds of points that are in the given location. Possible types of points:
• parcel_locker - Physical automatic parcel stations and shipment handling points where a parcel machine shipment can be sent.
• pop - Shipment handling points.
• parcel_locker_only - Only physical automatic parcel stations.
• parcel_locker_superpop - Shipment handling points which a parcel machine shipment can be sent to.
status
Point status.
location
Location object containing information on the geographic location: latitude and longitude.
Sample Location object in the JSON format:
Code Block |
---|
"latitude": 50.03988,
"longitude": 19.92485 |
location_type
Location type.
location_description
Additional information about point location that may make it easier to reach it.
location_description_1
Additional description.
location_description_2
Additional description.
distance
Distrance from a relative point stated in the search. If the relative point has not been provided, then it takes null value.
opening_hours
Point opening hours
address
Address object containing address information about the point such as: street, postal code, city. Sample Address object in the JSON format:
Code Block |
---|
"line1": "Kapelanka 14",
"line2": null |
address_details
Detailed point address data
Code Block |
---|
"city": "Bartoszyce",
"province": "Warmińsko-Mazurskie",
"post_code": "11-200",
"street": null,
"building_number": null,
"flat_number": null |
phone_number
Point telephone number
payment_point_descr
Additional information about the point
functions
Table specifying the functions offered by the point. Possible functions:
parcel=Send and collect standard parcel parcel_send=Standard parcel send parcel_collect=Standard parcel collect parcel_reverse_return_send=Standard parcel reverse return to sender standard_letter_collect=Standard letter collect standard_letter_send=Standard letter send allegro_parcel_collect=Allegro parcel collect allegro_parcel_send=Allegro parcel send allegro_parcel_reverse_return_send=Allegro parcel return to sender allegro_letter_collect=Allegro letter collect allegro_letter_send=Allegro letter send allegro_letterlettercouriercourierparcelcollectcouriercourierparcelsendcouriercourierparcel standardAvailability of payments in the given point.Is it a NEXT automatic parcel station
is_next
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.
virtual
virtual
Sample Point resource in the JSON format:
Authentication
Access to the resource does not require authentication..
List of points
Pobieranie listy punktów.
Code Block |
---|
GET /v1/points |
In the response the server will return a collection with the list of points.
The collection supports paging that is described on page API General.
Sample request
Response
Point details
Collecting point details.
Code Block |
---|
GET /v1/points/:nazwa_punktu |
In the response the server will return point details.
Sample request
Code Block |
---|
GET https://api-shipx-pl.easypack24.net/v1/points/AAB001 HTTP/1.1
Host: api-shipx-pl.easypack24.net |
Response
?virtual=1,6
updated_from
Search for points by the date when the point update was made. The parameter should be provided together with updated_to.
If the updated_to parameter has not been specified, the date cannot be earlier than 3 days back counting from the current date.
updated_to
Search for points by the date when the point update was made. The parameter should be provided together with updated_from.
If the updated_from parameter has not been specified, the date cannot be later than 3 days back counting from the updated_from parameter located as close as possible stated geographical coordinates. located as close as possible stated postal .Specifies distance in meters from the point stated in ..Using the parameter forces: Limit of returned points parameters in .Sorting resultsSorting .Sorting from the relative point Sorting Sorting done in both directions, using the sort_order parameter: points points
By default, the results are sorted ascending (asc) by point name (name).
Paging
page
Default value value displayed Specifies list of to be displayed on page.