Plain Flashcards API
HTTP API for device auth, translation, subscriptions, and AI flashcard jobs.
PF
Endpoints
| Method | Path | Auth | Purpose |
|---|---|---|---|
| GET | /health | No | Service and database health check. |
| GET | /api/v1/auth/init | No | Create a registration challenge. |
| POST | /api/v1/auth/register | No | Register a device public key and issue a session token. |
| POST | /api/v1/auth/refresh | No | Refresh a device session token. |
| GET | /api/v1/translate | Bearer JWT | Translate text through the configured translation service. |
| GET | /api/v1/translate/directions | Bearer JWT | List supported translation directions. |
| POST | /api/v1/flashcards/jobs | Bearer JWT | Create a prompt, image, or PDF flashcard generation job. |
| POST | /api/v1/flashcards/jobs/{id}/upload-complete | Bearer JWT | Confirm an uploaded image/PDF and queue processing. |
| GET | /api/v1/flashcards/jobs/{id} | Bearer JWT | Fetch one flashcard job. |
| GET | /api/v1/flashcards/jobs | Bearer JWT | List flashcard jobs for the current device. |
| GET | /api/v1/flashcards/credits | Bearer JWT | Read credit/free-use balance. |
| POST | /api/v1/webhook/rc | RevenueCat signature | Receive RevenueCat subscription events. |