API Collection
Ankiren Meditation User API
User-facing API for meditation playback, session tracking, and progress statistics
Production
https://ankiren.comStaginghttps://staging.ankiren.comUAThttps://uat.ankiren.comBASEhttps://ankiren.com
Overview
15 endpoint trong 6 nhóm · OpenAPI 3.0.3 · phiên bản 1.0.0 · spec tại docs/api/meditation-user-api.yaml.
Meditations3 endpoint
Browse and play meditations
Sessions4 endpoint
Session tracking (start, complete, abandon)
Stats2 endpoint
Progress statistics and charts
Goals2 endpoint
User-configurable meditation goals
Scenes1 endpoint
Ambient background scenes
Voice Preference3 endpoint
User's voice selection preference (v1.1.14)
Authentication
Mọi endpoint đều yêu cầu xác thực.
- sessionapiKey · cookie
NextAuth session cookie
- pathttp · bearer
Personal Access Token (ank_xxx)
cURL
curl 'https://ankiren.com/api/meditations' \ -H 'Authorization: Bearer <token>'
Topics
Meditations
Browse and play meditations
- GETList published meditations
/api/meditations - GETGet single meditation
/api/meditations/{id} - GETList all categories
/api/meditations/categories
Sessions
Session tracking (start, complete, abandon)
- GETGet user's meditation sessions
/api/meditations/sessions - POSTStart a meditation session
/api/meditations/sessions - GETGet single session
/api/meditations/sessions/{id} - PUTUpdate session status
/api/meditations/sessions/{id}
Stats
Progress statistics and charts
- GETGet basic meditation stats
/api/meditations/stats - GETGet chart data for progress tracking
/api/meditations/stats/weekly
Goals
User-configurable meditation goals
- GETGet user's meditation goals
/api/meditations/goals - PUTUpdate user's meditation goals
/api/meditations/goals
Voice Preference
User's voice selection preference (v1.1.14)
- GETGet user's voice preference
/api/me/voice-preference - PUTUpdate user's voice preference
/api/me/voice-preference - DELETEClear user's voice preference
/api/me/voice-preference