Skip to main content

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 3 >=3.7, <= 3.9. Install the package from PyPi using the following pip command:

pip install nkbjbjhbgvbhj==2.0

You can also view the package at: https://pypi.python.org/pypi/nkbjbjhbgvbhj

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
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
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.
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']
custom_header_api_key string
o_auth_client_id string OAuth 2 Client ID
o_auth_redirect_uri string OAuth 2 Redirection endpoint or Callback Uri
o_auth_token OAuthToken Object for storing information about the OAuth token
o_auth_scopes OAuthScopeEnum

The API client can be initialized as follows:

from swaggerpetstore.swaggerpetstore_client import SwaggerpetstoreClient
from swaggerpetstore.configuration import Environment

client = SwaggerpetstoreClient(
    custom_header_api_key='CustomHeaderApiKey',
    o_auth_client_id='OAuthClientId',
    o_auth_redirect_uri='OAuthRedirectUri',
    o_auth_scopes = [OAuthScopeEnum.READPETS, OAuthScopeEnum.WRITEPETS],
    environment=Environment.PRODUCTION,)

Authorization

This API uses Custom Header Signature, OAuth 2 Implicit Grant.

Implicit Grant

Your application must obtain user authorization before it can execute an endpoint call incase this SDK chooses to use OAuth 2.0 Implicit Grant to obtain a user's consent to perform an API request on user's behalf. This authorization includes the following steps

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_managers['petstoreAuth'].get_authorization_url()

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

This version

2.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nkbjbjhbgvbhj-2.0.tar.gz (21.7 kB view details)

Uploaded Source

Built Distribution

nkbjbjhbgvbhj-2.0-py3-none-any.whl (39.5 kB view details)

Uploaded Python 3

File details

Details for the file nkbjbjhbgvbhj-2.0.tar.gz.

File metadata

  • Download URL: nkbjbjhbgvbhj-2.0.tar.gz
  • Upload date:
  • Size: 21.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.34.0 CPython/3.6.8

File hashes

Hashes for nkbjbjhbgvbhj-2.0.tar.gz
Algorithm Hash digest
SHA256 63d65a41b046cb784dcedb5a7841c293e3350ab09110235b3ab96221f0e956e4
MD5 b4ff0a2f4cf1590f1ef0237126491725
BLAKE2b-256 5dff9d9481f21f4002980527721c1765f153f433ce19f430409e70fa6639e508

See more details on using hashes here.

File details

Details for the file nkbjbjhbgvbhj-2.0-py3-none-any.whl.

File metadata

  • Download URL: nkbjbjhbgvbhj-2.0-py3-none-any.whl
  • Upload date:
  • Size: 39.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.34.0 CPython/3.6.8

File hashes

Hashes for nkbjbjhbgvbhj-2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 c8b8159ee3f5256e607a275f43c529788de77873dceebb871bd42c7d5ca7e22b
MD5 4737645b0e78b0b35a5bc5d5c662dbcb
BLAKE2b-256 d1df11f566bc25a3cd2f73b4e2deefb732034b804f26d294bc39baf471ce7850

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page