openapi-python-sdk

A minimal Python SDK for Openapi® — the largest certified API marketplace in Italy. Provides the core HTTP primitives to authenticate and interact with any Openapi service, without API-specific coupling.

Requirements

• Python 3.10+
• An account on console.openapi.com with a valid API key

Installation

pip install openapi-python-sdk

Usage

Interaction with the Openapi platform happens in two distinct steps.

Step 1 — Generate a token

from openapi_python_sdk.client import OauthClient

oauth = OauthClient(username="<your_username>", apikey="<your_apikey>", test=True)

resp = oauth.create_token(
    scopes=[
        "GET:test.imprese.openapi.it/advance",
        "POST:test.postontarget.com/fields/country",
    ],
    ttl=3600,
)
token = resp["token"]

# Revoke the token when done
oauth.delete_token(id=token)

Step 2 — Call an API endpoint

from openapi_python_sdk.client import Client

client = Client(token=token)

# GET with query params
resp = client.request(
    method="GET",
    url="https://test.imprese.openapi.it/advance",
    params={"denominazione": "altravia", "provincia": "RM", "codice_ateco": "6201"},
)

# POST with a JSON payload
resp = client.request(
    method="POST",
    url="https://test.postontarget.com/fields/country",
    payload={"limit": 0, "query": {"country_code": "IT"}},
)

Testing

pip install pytest
pytest

OauthClient API

Client API

Links

• Homepage: openapi.it
• Console & API keys: console.openapi.com
• GitHub: github.com/openapi/openapi-python-sdk
• Issue tracker: github.com/openapi/openapi-python-sdk/issues

License

MIT — see LICENSE for details.

Authors

• Michael Cuffaro (@maiku1008)
• Openapi Team (@openapi-it)