Plain Flashcards API

HTTP API for device auth, translation, subscriptions, and AI flashcard jobs.

PF

Endpoints

MethodPathAuthPurpose
GET/healthNoService and database health check.
GET/api/v1/auth/initNoCreate a registration challenge.
POST/api/v1/auth/registerNoRegister a device public key and issue a session token.
POST/api/v1/auth/refreshNoRefresh a device session token.
GET/api/v1/translateBearer JWTTranslate text through the configured translation service.
GET/api/v1/translate/directionsBearer JWTList supported translation directions.
POST/api/v1/flashcards/jobsBearer JWTCreate a prompt, image, or PDF flashcard generation job.
POST/api/v1/flashcards/jobs/{id}/upload-completeBearer JWTConfirm an uploaded image/PDF and queue processing.
GET/api/v1/flashcards/jobs/{id}Bearer JWTFetch one flashcard job.
GET/api/v1/flashcards/jobsBearer JWTList flashcard jobs for the current device.
GET/api/v1/flashcards/creditsBearer JWTRead credit/free-use balance.
POST/api/v1/webhook/rcRevenueCat signatureReceive RevenueCat subscription events.