| Name | post-nl-sdk JSON |
| Version |
1.0.1
JSON |
| download |
| home_page | None |
| Summary | Collection of PostNL API's for ecommerce processes |
| upload_time | 2024-04-11 12:51:16 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
postnk
ecommerce
sdk
api
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Getting Started with PostNL
## Introduction
This is an API description. Add as many details as you like.
## Install the Package
The package is compatible with Python versions `3 >=3.7, <= 3.11`.
Install the package from PyPi using the following pip command:
```python
pip install post-nl-sdk==1.0.1
```
You can also view the package at:
https://pypi.python.org/pypi/post-nl-sdk/1.0.1
## Test the SDK
You can test the generated SDK and the server with test cases. `unittest` is used as the testing framework and `pytest` is used as the test runner. You can run the tests as follows:
Navigate to the root directory of the SDK and run the following commands
```
pip install -r test-requirements.txt
pytest
```
## Initialize the API Client
**_Note:_** Documentation for the client can be found [here.](doc/client.md)
The following parameters are configurable for the API Client:
| Parameter | Type | Description |
| --- | --- | --- |
| `environment` | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION_SERVER`** |
| `http_client_instance` | `HttpClient` | The Http Client passed from the sdk user for making requests |
| `override_http_client_configuration` | `bool` | The value which determines to override properties of the passed Http Client from the sdk user |
| `http_call_back` | `HttpCallBack` | The callback value that is invoked before and after an HTTP call is made to an endpoint |
| `timeout` | `float` | The value to use for connection timeout. <br> **Default: 60** |
| `max_retries` | `int` | The number of times to retry an endpoint call if it fails. <br> **Default: 3** |
| `backoff_factor` | `float` | A backoff factor to apply between attempts after the second try. <br> **Default: 2** |
| `retry_statuses` | `Array of int` | The http statuses on which retry is to be done. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
| `retry_methods` | `Array of string` | The http methods on which retry is to be done. <br> **Default: ['GET', 'PUT']** |
| `custom_header_authentication_credentials` | [`CustomHeaderAuthenticationCredentials`](__base_path/$a/custom-header-signature.md) | The credential object for Custom Header Signature |
The API client can be initialized as follows:
```python
client = PostnlClient(
custom_header_authentication_credentials=CustomHeaderAuthenticationCredentials(
apikey='apikey'
)
)
```
API calls return an `ApiResponse` object that includes the following fields:
| Field | Description |
| --- | --- |
| `status_code` | Status code of the HTTP response |
| `reason_phrase` | Reason phrase of the HTTP response |
| `headers` | Headers of the HTTP response as a dictionary |
| `text` | The body of the HTTP response as a string |
| `request` | HTTP request info |
| `errors` | Errors, if they exist |
| `body` | The deserialized body of the HTTP response |
## Environments
The SDK can be configured to use a different environment for making API calls. Available environments are:
### Fields
| Name | Description |
| --- | --- |
| Production server | **Default** |
| Non-Production server | - |
## Authorization
This API uses the following authentication schemes.
* [`APIKeyHeader (Custom Header Signature)`](__base_path/$a/custom-header-signature.md)
## List of APIs
* [Postalcodecheck](doc/controllers/postalcodecheck.md)
* [Track Trace](doc/controllers/track-trace.md)
* [Barcode](doc/controllers/barcode.md)
* [Checkout](doc/controllers/checkout.md)
* [Confirming](doc/controllers/confirming.md)
* [Deliverydate](doc/controllers/deliverydate.md)
* [Labelling](doc/controllers/labelling.md)
* [Locations](doc/controllers/locations.md)
* [Shipment](doc/controllers/shipment.md)
* [Timeframes](doc/controllers/timeframes.md)
## Classes Documentation
* [Utility Classes](doc/utility-classes.md)
* [HttpResponse](doc/http-response.md)
* [HttpRequest](doc/http-request.md)
Raw data
{
"_id": null,
"home_page": null,
"name": "post-nl-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "PostNK, ecommerce, SDK, API",
"author": null,
"author_email": "PostNL <apimatic@postnl.nl>",
"download_url": "https://files.pythonhosted.org/packages/73/06/1ad65626c6863873f07cea5bd381cc64906575119a8678aae822b21b1aba/post-nl-sdk-1.0.1.tar.gz",
"platform": null,
"description": "\n# Getting Started with PostNL\n\n## Introduction\n\nThis is an API description. Add as many details as you like.\n\n## Install the Package\n\nThe package is compatible with Python versions `3 >=3.7, <= 3.11`.\nInstall the package from PyPi using the following pip command:\n\n```python\npip install post-nl-sdk==1.0.1\n```\n\nYou can also view the package at:\nhttps://pypi.python.org/pypi/post-nl-sdk/1.0.1\n\n## Test the SDK\n\nYou can test the generated SDK and the server with test cases. `unittest` is used as the testing framework and `pytest` is used as the test runner. You can run the tests as follows:\n\nNavigate to the root directory of the SDK and run the following commands\n\n```\npip install -r test-requirements.txt\npytest\n```\n\n## Initialize the API Client\n\n**_Note:_** Documentation for the client can be found [here.](doc/client.md)\n\nThe following parameters are configurable for the API Client:\n\n| Parameter | Type | Description |\n| --- | --- | --- |\n| `environment` | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION_SERVER`** |\n| `http_client_instance` | `HttpClient` | The Http Client passed from the sdk user for making requests |\n| `override_http_client_configuration` | `bool` | The value which determines to override properties of the passed Http Client from the sdk user |\n| `http_call_back` | `HttpCallBack` | The callback value that is invoked before and after an HTTP call is made to an endpoint |\n| `timeout` | `float` | The value to use for connection timeout. <br> **Default: 60** |\n| `max_retries` | `int` | The number of times to retry an endpoint call if it fails. <br> **Default: 3** |\n| `backoff_factor` | `float` | A backoff factor to apply between attempts after the second try. <br> **Default: 2** |\n| `retry_statuses` | `Array of int` | The http statuses on which retry is to be done. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |\n| `retry_methods` | `Array of string` | The http methods on which retry is to be done. <br> **Default: ['GET', 'PUT']** |\n| `custom_header_authentication_credentials` | [`CustomHeaderAuthenticationCredentials`](__base_path/$a/custom-header-signature.md) | The credential object for Custom Header Signature |\n\nThe API client can be initialized as follows:\n\n```python\nclient = PostnlClient(\n custom_header_authentication_credentials=CustomHeaderAuthenticationCredentials(\n apikey='apikey'\n )\n)\n```\n\nAPI calls return an `ApiResponse` object that includes the following fields:\n\n| Field | Description |\n| --- | --- |\n| `status_code` | Status code of the HTTP response |\n| `reason_phrase` | Reason phrase of the HTTP response |\n| `headers` | Headers of the HTTP response as a dictionary |\n| `text` | The body of the HTTP response as a string |\n| `request` | HTTP request info |\n| `errors` | Errors, if they exist |\n| `body` | The deserialized body of the HTTP response |\n\n## Environments\n\nThe SDK can be configured to use a different environment for making API calls. Available environments are:\n\n### Fields\n\n| Name | Description |\n| --- | --- |\n| Production server | **Default** |\n| Non-Production server | - |\n\n## Authorization\n\nThis API uses the following authentication schemes.\n\n* [`APIKeyHeader (Custom Header Signature)`](__base_path/$a/custom-header-signature.md)\n\n## List of APIs\n\n* [Postalcodecheck](doc/controllers/postalcodecheck.md)\n* [Track Trace](doc/controllers/track-trace.md)\n* [Barcode](doc/controllers/barcode.md)\n* [Checkout](doc/controllers/checkout.md)\n* [Confirming](doc/controllers/confirming.md)\n* [Deliverydate](doc/controllers/deliverydate.md)\n* [Labelling](doc/controllers/labelling.md)\n* [Locations](doc/controllers/locations.md)\n* [Shipment](doc/controllers/shipment.md)\n* [Timeframes](doc/controllers/timeframes.md)\n\n## Classes Documentation\n\n* [Utility Classes](doc/utility-classes.md)\n* [HttpResponse](doc/http-response.md)\n* [HttpRequest](doc/http-request.md)\n\n",
"bugtrack_url": null,
"license": null,
"summary": "Collection of PostNL API's for ecommerce processes",
"version": "1.0.1",
"project_urls": {
"Documentation": "https://developer.postnl.nl/"
},
"split_keywords": [
"postnk",
" ecommerce",
" sdk",
" api"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b46aa97675ff70a1d52e22e898fa08e37260c251f1ad9856c70aff7510c75621",
"md5": "d1bdf7f7c4dec83623e252b7bae4f5b6",
"sha256": "d78b6c802389dbf4c4129e7b039a850ae6b14c43e93386eacff39774aba6c122"
},
"downloads": -1,
"filename": "post_nl_sdk-1.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d1bdf7f7c4dec83623e252b7bae4f5b6",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 174100,
"upload_time": "2024-04-11T12:51:13",
"upload_time_iso_8601": "2024-04-11T12:51:13.146448Z",
"url": "https://files.pythonhosted.org/packages/b4/6a/a97675ff70a1d52e22e898fa08e37260c251f1ad9856c70aff7510c75621/post_nl_sdk-1.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "73061ad65626c6863873f07cea5bd381cc64906575119a8678aae822b21b1aba",
"md5": "640f17a85e8365cea1bc8b8274ac12a6",
"sha256": "9e3f476e9821032100b9ffc5ed2d780312f96d0f4051ca4a7bbaa96a87b98396"
},
"downloads": -1,
"filename": "post-nl-sdk-1.0.1.tar.gz",
"has_sig": false,
"md5_digest": "640f17a85e8365cea1bc8b8274ac12a6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 56288,
"upload_time": "2024-04-11T12:51:16",
"upload_time_iso_8601": "2024-04-11T12:51:16.736695Z",
"url": "https://files.pythonhosted.org/packages/73/06/1ad65626c6863873f07cea5bd381cc64906575119a8678aae822b21b1aba/post-nl-sdk-1.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-11 12:51:16",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "post-nl-sdk"
}
