celitech-sdk 2.0.0

Welcome to the CELITECH API documentation!

Celitech Python SDK 2.0.0

Welcome to the Celitech SDK documentation. This guide will help you get started with integrating and using the Celitech SDK in your project.

Versions

• API version: 2.0.0
• SDK version: 2.0.0

About the API

Welcome to the CELITECH API documentation!

Useful links: Homepage | Support email | Blog

Table of Contents

• Setup & Configuration
  • Supported Language Versions
  • Installation
• Authentication
  • OAuth Authentication
  • Environment Variables
• Setting a Custom Timeout
• Sample Usage
• Services
• Models
• License

Setup & Configuration

Supported Language Versions

This SDK is compatible with the following versions: Python >= 3.7

Installation

To get started with the SDK, we recommend installing using pip:

pip install celitech-sdk

If you are using Python 3, you can use pip3 instead:

pip3 install celitech-sdk

Authentication

OAuth Authentication

The Celitech API uses OAuth 2.0 for authentication.

You need to provide your OAuth credentials when initializing the SDK. Tokens are automatically fetched, cached, and refreshed — you do not need to manage them yourself.

sdk = Celitech(
    client_id="CLIENT_ID",
    client_secret="CLIENT_SECRET"
)

If you need to set or update the OAuth credentials after the SDK initialization, you can use:

sdk.set_client_id("CLIENT_ID")
sdk.set_client_secret("CLIENT_SECRET")

Environment Variables

These are the environment variables for the SDK:

Name	Description
CLIENT_ID	Client ID parameter
CLIENT_SECRET	Client Secret parameter

Environment variables are a way to configure your application outside the code. You can set these environment variables on the command line or use your project's existing tooling for managing environment variables.

If you are using a .env file, a template with the variable names is provided in the .env.example file located in the same directory as this README.

Setting a Custom Timeout

You can set a custom timeout for the SDK's HTTP requests as follows:

from celitech import Celitech

sdk = Celitech(timeout=10000)

Sample Usage

Below is a comprehensive example demonstrating how to authenticate and call a simple endpoint:

from celitech import Celitech

sdk = Celitech(
    client_id="CLIENT_ID",
    client_secret="CLIENT_SECRET"
)

result = sdk.destinations.list_destinations()

print(result)

Async Usage

The SDK includes an Async Client for making asynchronous API requests. This is useful for applications that need non-blocking operations, like web servers or apps with a graphical user interface.

import asyncio
from celitech import CelitechAsync

sdk = CelitechAsync(
    client_id="CLIENT_ID",
    client_secret="CLIENT_SECRET"
)


async def main():
  result = await sdk.destinations.list_destinations()
  print(result)

asyncio.run(main())

Services

The SDK provides various services to interact with the API.

Below is a list of all available services:

Name
destinations
packages
purchases
e_sim
i_frame

Models

The SDK includes several models that represent the data structures used in API requests and responses. These models help in organizing and managing the data efficiently.

Below is a list of all available models:

Name	Description
ListDestinationsOkResponse
ListPackagesOkResponse
CreatePurchaseV2Request
CreatePurchaseV2OkResponse
ListPurchasesOkResponse
CreatePurchaseRequest
CreatePurchaseOkResponse
TopUpEsimRequest
TopUpEsimOkResponse
EditPurchaseRequest
EditPurchaseOkResponse
GetPurchaseConsumptionOkResponse
GetEsimOkResponse
GetEsimDeviceOkResponse
GetEsimHistoryOkResponse
TokenOkResponse
GrantType
BadRequest
Unauthorized

License

This SDK is licensed under the MIT License.

See the LICENSE file for more details.