Platform | Postal Code

Service to manage entities of type 'PostalZone'.

Overview

api/{tenantKey}/{orgKey}/corePatterns/postalZones

URL	api/{tenantKey}/{orgKey}/corePatterns/postalZones
Methods Supported	GET, POST, PUT, DELETE

All Operations

This service includes the following operations:

GET:
POST:
- POST PostalZones
PUT:
DELETE:
- DELETE PostalZone by identifier
- DELETE PostalZone by key

All Resources

This service uses the following resources:

ApiPostalZoneResource
PostalZoneResource

GET Operations

GET PostalZones

Returns the list of all the entity records available.

Response:

When successful, the response body contains the list of records available. See PostalZoneResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones

GET /corePatterns/postalZones

GET PostalZones (paged)

Returns a page of the list of all the entity records available.

The following elements are optional:

page	(int) The index of the page of the list that should be returned. This is a query string parameter.
pageSize	(int) The number of page elements that should be returned (max. is 1000). This is a query string parameter.

Response:

When successful, the response body contains the list of records available. See PostalZoneResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones?page={page}&pageSize={pageSize}

GET /corePatterns/postalZones?page={page}&pageSize={pageSize}

GET PostalZone by identifier

Returns the entity record that matches the specified identifier.

The following elements are required:

id	(string) The record identifier.

Response:

When successful, the response body contains the entity record. See PostalZoneResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{id}

GET /corePatterns/postalZones/{id}

GET PostalZone by key

Returns the entity record that matches the specified key.

The following elements are required:

code	(string) The postal zone’s code.

Response:

When successful, the response body contains the entity record. See PostalZoneResource.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}

GET /corePatterns/postalZones/{code}

GET Print PostalZone by identifier

Prints the specified entity record.

The following elements are required:

id	(string) The record identifier.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
404	NotFound. The specified resord does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{id}/print?template={template}

GET /corePatterns/postalZones/{id}/print?template={template}

GET Print PostalZone by key

Prints the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/print

GET /corePatterns/postalZones/{code}/print

GET Original Print PostalZoneOriginal by identifier

Prints the specified entity record.

The following elements are required:

id	(string) The record identifier.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
404	NotFound. The specified resord does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{id}/printOriginal?template={template}

GET /corePatterns/postalZones/{id}/printOriginal?template={template}

GET Original Print PostalZone by key

Prints the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.

The following elements are optional:

template

(string) The report template that should be used. This is a query string parameter.

Response:

When successful, the response body contains a stream with the printed file.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/printOriginal

GET /corePatterns/postalZones/{code}/printOriginal

POST Operations

POST PostalZones

Creates a new entity record.

The following elements are required:

postalZoneResource

(ApiPostalZoneResource) The request body should contain the entity record that should be created.
See ApiPostalZoneResource.

Response:

When successful, the response body contains the new entity record identifier. The resource header location property contains the URL for the new entity record. See ApiPostalZoneResource.

Response status codes:

201	Created. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones

POST /corePatterns/postalZones

PUT Operations

PUT Set Code PostalZone

Updates the value of attribute 'Code' in the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/code

PUT /corePatterns/postalZones/{code}/code

PUT Set Country PostalZone

Updates the value of attribute 'Country' in the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/country

PUT /corePatterns/postalZones/{code}/country

PUT Set Description PostalZone

Updates the value of attribute 'Description' in the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/description

PUT /corePatterns/postalZones/{code}/description

PUT Set IsActive PostalZone

Updates the value of attribute 'IsActive' in the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.
value	(bool) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/isActive

PUT /corePatterns/postalZones/{code}/isActive

PUT Set Region PostalZone

Updates the value of attribute 'Region' in the specified entity record.

The following elements are required:

code	(string) The postal zone’s code.
value	(string) The request body should contain the new value for the attribute.

Response:

When successful, the response body is empty.

Response status codes:

200	OK. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}/region

PUT /corePatterns/postalZones/{code}/region

DELETE Operations

DELETE PostalZone by identifier

Deletes the entity record that matches the specified identifier.

The following elements are required:

id	(string) The record identifier.

Response:

When successful, the response body is empty.

Response status codes:

204	Deleted. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{id}

DELETE /corePatterns/postalZones/{id}

DELETE PostalZone by key

Deletes the entity record that matches the specified key.

The following elements are required:

code	(string) The postal zone’s code.

Response:

When successful, the response body is empty.

Response status codes:

204	Deleted. The operation was completed successfully.
400	BadRequest. The request parameters are invalid.
404	NotFound. The specified record does not exist.

Resource URL:

api/{tenantKey}/{orgKey}/corePatterns/postalZones/{code}

DELETE /corePatterns/postalZones/{code}

Resources

ApiPostalZoneResource

The following elements are required:

code	(string) The postal zone’s code.
country	(string) The postal zone’s country.

The following elements are optional:

description	(string) The postal zone’s description.
region	(string) The postal zone’s region.

PostalZoneResource

The following elements are required:

code	(string) The postal zone’s code.
country	(string) The postal zone’s country. (fk) Allowed value: the natural key of a record of type Country. These records are accessibly through the Countries service.

The following elements are optional:

description	(string) The postal zone’s description.
region	(string) The postal zone’s region. (fk) Allowed value: the natural key of a record of type Region. These records are accessibly through the Regions service.