Python client library for Swagger Petstore API
Project description
Getting Started with Swagger Petstore
Introduction
This is a sample server Petstore server. You can find out more about Swagger at http://swagger.io or on irc.freenode.net, #swagger. For this sample, you can use the api key special-key
to test the authorization filters.
Find out more about Swagger: http://swagger.io
Install the Package
The package is compatible with Python versions 2 >=2.7.9
and 3 >=3.4
.
Install the package from PyPi using the following pip command:
pip install swagger-petstorepackage==1.0.0
You can also view the package at: https://pypi.python.org/pypi/swagger-petstorepackage
Initialize the API Client
Note: Documentation for the client can be found here.
The following parameters are configurable for the API Client:
Parameter | Type | Description |
---|---|---|
o_auth_client_id |
string |
OAuth 2 Client ID |
o_auth_redirect_uri |
string |
OAuth 2 Redirection endpoint or Callback Uri |
environment |
Environment | The API environment. Default: Environment.PRODUCTION |
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 |
timeout |
float |
The value to use for connection timeout. Default: 60 |
max_retries |
int |
The number of times to retry an endpoint call if it fails. Default: 0 |
backoff_factor |
float |
A backoff factor to apply between attempts after the second try. Default: 2 |
retry_statuses |
Array of int |
The http statuses on which retry is to be done. 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. Default: ['GET', 'PUT'] |
The API client can be initialized as follows:
from swaggerpetstore.swaggerpetstore_client import SwaggerpetstoreClient
from swaggerpetstore.configuration import Environment
client = SwaggerpetstoreClient(
o_auth_client_id='OAuthClientId',
o_auth_redirect_uri='OAuthRedirectUri',
environment=Environment.PRODUCTION,)
Authorization
The SDK will attempt to authorize by providing no scopes in case an endpoint requiring authentication is called. You can also authorize the client yourself.
Your application must obtain user authorization before it can execute an endpoint call. The SDK uses OAuth 2.0 Implicit Grant to obtain a user's consent to perform an API request on user's behalf.
This process requires the presence of a client-side JavaScript code on the redirect URI page to receive the access token after the consent step is completed.
1- Obtain user consent
To obtain user's consent, you must redirect the user to the authorization page. The get_authorization_url()
method creates the URL to the authorization page. You must pass the scopes for which you need permission to access.
auth_url = client.auth.get_authorization_url([OAuthScopeEnum.READPETS, OAuthScopeEnum.WRITEPETS])
2- Handle the OAuth server response
Once the user responds to the consent request, the OAuth 2.0 server responds to your application's access request by redirecting the user to the redirect URI specified set in Configuration
.
The redirect URI will receive the access token as the token
argument in the URL fragment.
https://example.com/oauth/callback#token=XXXXXXXXXXXXXXXXXXXXXXXXX
The access token must be extracted by the client-side JavaScript code. The access token can be used to authorize any further endpoint calls by the JavaScript code.
Scopes
Scopes enable your application to only request access to the resources it needs while enabling users to control the amount of access they grant to your application. Available scopes are defined in the OAuthScopeEnum
enumeration.
Scope Name | Description |
---|---|
READPETS |
read your pets |
WRITEPETS |
modify pets in your account |
List of APIs
Classes Documentation
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for swagger-petstorepackage-1.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | db28fe30704dfd8a7cdc42b84a2f6cbdb5c9c41a8546cb9d9b158ea203b5032d |
|
MD5 | d0a442d543ce866fe83f99c728e1f28d |
|
BLAKE2b-256 | 0fb1a6269f8c6e17d3157293f245a430aeab84ca36bebd486cc58c565172afc0 |
Hashes for swagger_petstorepackage-1.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 52b1eefd950e82bf658676e33ca6a964396d3618ea68303279e7680aaeeebdcc |
|
MD5 | 04acd018db24eb93e3f1d580d65adca1 |
|
BLAKE2b-256 | d8cf28ad076e7b5fe6a2366d45ccc95320ec5b329ee42a09e27795d05d4d3c81 |