tidycal-python

tidycal-python is an API wrapper for Tidycal, written in Python.
This library uses Oauth2 for authentication.

Installing

pip install tidycal-python

Usage

from tidycal.client import Client
client = Client(client_id, client_secret, redirect_uri=redirect_uri)

To obtain and set an access token, follow this instructions:

1. Get authorization URL

url = client.authorization_url(state=None)
# This call generates the url necessary to display the pop-up window to perform oauth authentication
# param state(code) is required for direct request for oauth, for local test isn't necessary

2. Get access token using code

token = client.get_access_token(code)
# "code" is the same response code after login with oauth with the above url.

3. Refresh access token using refresh_token

token = client.refresh_access_token(refresh_token)
# "refresh_token" is the token refresh in response after login with oauth with the above url.

- Get current user

client.get_current_user()

- List of Bookings

client.list_bookings(starts_at=None, ends_at=None, cancelled=None, page=None)
# Receives only one parameter at a time
# starts_at = DATE, Get bookings starting from a specific date.
# ends_at = DATE, Get bookings ending before a specific date.
# cancelled = BOOLEAN, Get only cancelled bookings.
# page = NUMBER, Page number.

- List of Booking Types

client.list_booking_types()

- List of Contacts

client.list_contacts()