v1.0.0 — Production Ready

Build with PTAIDE

Official SDKs for the PTAIDE PhysioAide Client REST API. Full-featured client libraries for Python, Flutter, and JavaScript with type safety and comprehensive documentation.

3
Languages
40+
Endpoints
100%
Type Safe
MIT
License

Choose Your SDK

Pick the SDK that fits your stack. All SDKs share the same API design.

🐍

Python SDK

ptaide-rest-api-client-sdk

Async-first Python client with Pydantic models. Perfect for backend services and data pipelines.

  • Pydantic v2 models
  • Async/await support
  • Type hints everywhere
  • Poetry packaging
View Examples →
💙

Flutter SDK

ptaide_rest_api_client_sdk

Native Dart package for Flutter apps. Includes secure token storage and offline support.

  • Null safety
  • SharedPreferences tokens
  • JSON serialization
  • Cross-platform
View Examples →

JavaScript SDK

ptaide-rest-api-client-sdk

TypeScript-first SDK for web and Node.js. Full type definitions with zero dependencies.

  • TypeScript native
  • Tree-shakeable
  • Browser + Node.js
  • ESM & CommonJS
View Examples →

Quick Start

Get up and running in seconds with these examples.

# Install with pip or poetry
pip install ptaide-rest-api-client-sdk

from ptaide_rest_api_client_sdk import PTAideClient

# Initialize client
client = PTAideClient(base_url="https://client.api.ptaide.com")

# Authenticate
auth = client.auth.login(
    email="therapist@clinic.com",
    password="secure_password"
)
client.set_access_token(auth.access_token)

# Get your clinics
clinics = client.employees.get_my_clinics()

# Create a therapy program
program = client.programs.create(
    name="Back Rehabilitation",
    clinic_id=clinics[0]["clinic_id"],
    patient_id="PAT001"
)
// Add to pubspec.yaml
// dependencies:
//   ptaide_rest_api_client_sdk: ^1.0.0

import 'package:ptaide_rest_api_client_sdk/ptaide_rest_api_client_sdk.dart';

// Initialize client
final client = PTAideClient(
  baseUrl: 'https://client.api.ptaide.com',
);

// Authenticate
final auth = await client.auth.login(
  email: 'therapist@clinic.com',
  password: 'secure_password',
);
client.setAccessToken(auth.accessToken);

// Get patient's clinics (for patient users)
final clinics = await client.patients.getMyClinics();

// Get exercises
final exercises = await client.exercises.list(
  category: 'STRETCHING',
);
// Install with npm
npm install ptaide-rest-api-client-sdk

import { PTAideClient } from 'ptaide-rest-api-client-sdk';

// Initialize client
const client = new PTAideClient({
  baseUrl: 'https://client.api.ptaide.com'
});

// Authenticate
const auth = await client.auth.login({
  email: 'therapist@clinic.com',
  password: 'secure_password'
});
client.setAccessToken(auth.accessToken);

// Get clinic patients
const patients = await client.clinics.getPatients('CLINIC001');

// Create session
const session = await client.sessions.create({
  clinicId: 'CLINIC001',
  patientIds: ['PAT001'],
  startTime: new Date()
});

Built for Developers

Everything you need to integrate PTAIDE into your applications.

🔐

JWT Authentication

Secure token-based auth with automatic refresh and device management.

📝

Type Safety

Full type definitions for all models and API responses.

🏥

Clinic Management

Multi-clinic support with therapist and patient relationships.

📋

Programs & Exercises

Create therapy programs with exercises, sets, reps, and difficulty.

📊

Session Tracking

Track exercise performance, form scores, and patient progress.

Async First

Non-blocking operations for responsive applications.

API Coverage

All SDKs provide complete coverage of the PTAIDE REST API.

POST /auth/login Authenticate user
GET /employees/me/clinics My clinics
GET /patients/me/clinics Patient clinics
GET /clinics/{id}/patients Clinic patients
POST /programs Create program
POST /programs/{id}/exercises Add exercise
GET /exercises List exercises
POST /sessions Create session