Skip to main content

Python Client SDK for Unified.to

Project description

Summary

Unified.to API: One API to Rule Them All

Table of Contents

SDK Installation

The SDK can be installed using the pip package manager, with dependencies and metadata stored in the setup.py file.

pip install Unified-python-sdk

SDK Example Usage

Example

import unified_to
from unified_to.models import operations

s = unified_to.UnifiedTo()


res = s.accounting.create_accounting_account(request=operations.CreateAccountingAccountRequest(
    connection_id='<value>',
))

if res.accounting_account is not None:
    # handle response
    pass

Available Resources and Operations

Available methods

account

accounting

activity

apicall

application

applicationstatus

ats

auth

branch

call

candidate

channel

class_

collection

commerce

commit

company

connection

contact

course

crm

customer

deal

document

employee

enrich

event

file

genai

group

hris

instructor

integration

interview

inventory

invoice

issue

item

job

journal

kms

lead

link

list

lms

location

login

martech

member

message

messaging

model

note

order

organization

page

passthrough

payment

payout

payslip

person

pipeline

project

prompt

pullrequest

refund

repo

repository

scim

scorecard

space

storage

student

task

taxrate

ticket

ticketing

timeoff

transaction

uc

unified

user

webhook

Error Handling

Handling errors in this SDK should largely match your expectations. All operations return a response object or raise an exception.

By default, an API error will raise a errors.SDKError exception, which has the following properties:

Property Type Description
.status_code int The HTTP status code
.message str The error message
.raw_response httpx.Response The raw HTTP response
.body str The response content

When custom error responses are specified for an operation, the SDK may also raise their associated exception. You can refer to respective Errors tables in SDK docs for more details on possible exception types for each operation. For example, the create_accounting_account method may raise the following exceptions:

Error Type Status Code Content Type
errors.SDKError 4XX, 5XX */*

Example

import unified_to
from unified_to.models import errors, operations

s = unified_to.UnifiedTo()

res = None
try:
    res = s.accounting.create_accounting_account(request=operations.CreateAccountingAccountRequest(
    connection_id='<value>',
))

except errors.SDKError as e:
    # handle exception
    raise(e)

if res.accounting_account is not None:
    # handle response
    pass

Server Selection

Select Server by Index

You can override the default server globally by passing a server index to the server_idx: int optional parameter when initializing the SDK client instance. The selected server will then be used as the default on the operations that use it. This table lists the indexes associated with the available servers:

# Server
0 https://api.unified.to
1 https://api-eu.unified.to

Example

import unified_to
from unified_to.models import operations

s = unified_to.UnifiedTo(
    server_idx=1,
)


res = s.accounting.create_accounting_account(request=operations.CreateAccountingAccountRequest(
    connection_id='<value>',
))

if res.accounting_account is not None:
    # handle response
    pass

Override Server URL Per-Client

The default server can also be overridden globally by passing a URL to the server_url: str optional parameter when initializing the SDK client instance. For example:

import unified_to
from unified_to.models import operations

s = unified_to.UnifiedTo(
    server_url="https://api.unified.to",
)


res = s.accounting.create_accounting_account(request=operations.CreateAccountingAccountRequest(
    connection_id='<value>',
))

if res.accounting_account is not None:
    # handle response
    pass

Custom HTTP Client

The Python SDK makes API calls using the requests HTTP library. In order to provide a convenient way to configure timeouts, cookies, proxies, custom headers, and other low-level configuration, you can initialize the SDK client with a custom requests.Session object.

For example, you could specify a header for every request that this sdk makes as follows:

import unified_to
import requests

http_client = requests.Session()
http_client.headers.update({'x-custom-header': 'someValue'})
s = unified_to.UnifiedTo(client=http_client)

Authentication

Per-Client Security Schemes

This SDK supports the following security scheme globally:

Name Type Scheme
jwt apiKey API key

You can set the security parameters through the security optional parameter when initializing the SDK client instance. For example:

import unified_to
from unified_to.models import operations, shared

s = unified_to.UnifiedTo(
    security=shared.Security(
        jwt="<YOUR_API_KEY_HERE>",
    ),
)


res = s.accounting.create_accounting_account(request=operations.CreateAccountingAccountRequest(
    connection_id='<value>',
))

if res.accounting_account is not None:
    # handle response
    pass

Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!

SDK Created by Speakeasy

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

Unified-python-sdk-0.25.0.tar.gz (183.0 kB view details)

Uploaded Source

Built Distribution

Unified_python_sdk-0.25.0-py3-none-any.whl (596.0 kB view details)

Uploaded Python 3

File details

Details for the file Unified-python-sdk-0.25.0.tar.gz.

File metadata

  • Download URL: Unified-python-sdk-0.25.0.tar.gz
  • Upload date:
  • Size: 183.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.18

File hashes

Hashes for Unified-python-sdk-0.25.0.tar.gz
Algorithm Hash digest
SHA256 71caa8939a77ca3acd29455824b4527d0b1218ef80746eaf9b377cdded568a99
MD5 cab98f351312f9182b92b8665a468ce9
BLAKE2b-256 ab5564a094afa3a35d4602ce091b28037e584fad103eef752a729ef986aa160a

See more details on using hashes here.

File details

Details for the file Unified_python_sdk-0.25.0-py3-none-any.whl.

File metadata

File hashes

Hashes for Unified_python_sdk-0.25.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2943d90c0d3b703972a8f264f4e1eb75f3a50595260f71fb65a45b99cc74b882
MD5 1b19ac42c5013249b73e2adc8cc87f13
BLAKE2b-256 7966533ad330519268e092a369c505fc76d6362870eb092866fee0164fface04

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