API Documentation

Integrate Wisply into your macOS application with our comprehensive API.

Authentication
Secure passkey-based authentication using WebAuthn

POST /api/auth/register/options

Generate registration options for a new passkey

Body: { "email": "user@example.com" }

POST /api/auth/register/verify

Verify passkey registration

Body: { "email", "response", "challenge" }

POST /api/auth/authenticate/options

Generate authentication options

Body: { "email": "user@example.com" }

POST /api/auth/authenticate/verify

Verify authentication response

Body: { "response", "challenge" }
Subscription Management
Manage user subscriptions and billing

GET /api/subscription/status

Get current subscription status (Bearer token)

Header: Authorization: Bearer <token>

POST /api/subscription/status

Get current subscription status (legacy)

Body: { "userId": "user_id" }

POST /api/subscription/create

Create a new subscription

Body: { "userId", "tier", "billingPeriod" }

POST /api/subscription/webhook

Stripe webhook endpoint

Stripe Signature Required
User Management
User profile and data synchronization

GET /api/user/profile

Get user profile information (Bearer token)

Header: Authorization: Bearer <token>

PATCH /api/user/profile

Update user profile (Bearer token)

Header: Authorization: Bearer <token>
Body: { "name": "New Name" }

POST /api/user/sync

Sync offline data to cloud

Premium only