Authentication Examples

import time
import requests

CLIENT_ID = "your_client_id"
CLIENT_SECRET = "your_client_secret"
AUTH_URL = "https://dev.simplifi.work/oauth/token"
BASE_URL = "https://dev.simplifi.work/api"

class SimplifiClient:
    def __init__(self, client_id: str, client_secret: str):
        self.client_id = client_id
        self.client_secret = client_secret
        self._token: str | None = None
        self._token_expiry: float = 0

    def get_access_token(self) -> str:
        response = requests.post(
            AUTH_URL,
            data={"grant_type": "client_credentials"},
            auth=(self.client_id, self.client_secret),
        )
        response.raise_for_status()
        data = response.json()
        self._token = data["access_token"]
        # Subtract 30 seconds as a buffer so we refresh slightly before 			 expiry
        self._token_expiry = time.time() + data["expires_in"] - 30
        return self._token

	# Is the token expired? if so _get_access_token
    def get_valid_token(self) -> str:
        if self._token is None or time.time() >= self._token_expiry:
            self.get_access_token()
        return self._token

    def request(self, method: str, path: str, **kwargs) -> dict:
        token = self.get_valid_token()
        response = requests.request(
            method,
            f"{BASE_URL}{path}",
            headers={"Authorization": f"Bearer {token}"},
            **kwargs,
        )
        if response.status_code == 401:
            # Token rejected by server — force a refresh and retry once
            self._token = None
            token = self._get_valid_token()
            response = requests.request(
                method,
                f"{BASE_URL}{path}",
                headers={"Authorization": f"Bearer {token}"},
                **kwargs,
            )
        response.raise_for_status()
        return response.json()

    def get_employee(self, employee_id: str) -> dict:
        return self.request("GET", f"/v1/employees/{employee_id}")

    def get_employees(self) -> list:
        return self.request("GET", "/v1/employees")


# Usage
client = SimplifiClient(CLIENT_ID, CLIENT_SECRET)
employee = client.get_employee("123")