डेवलपर्स
bollyiq.com और bollyiq ऐप्स एक ही REST API पर चलते हैं, जिसे OpenAPI 3.1 कॉन्ट्रैक्ट में बताया गया है। AI असिस्टेंट PKCE के साथ OAuth 2.1 से MCP सर्वर के ज़रिए कनेक्ट हो सकते हैं। /openapi.json · /mcp
- Guests: send an
X-Guest-IdUUID (or omit it and read thex-guest-idresponse header). - Signed-in users: sign in via
/api/auth(email code, magic link or Google) and sendAuthorization: Bearer <token>(theset-auth-tokenresponse header). - Errors:
application/problem+json. Scoring is always computed on the server. - UI strings:
/api/v1/i18n/{locale}serves the same translations the website uses.
Endpoints
- GET/api/v1/daily Today's games and whether each is published
- GET/api/v1/daily/{game} Public payload for today's puzzle (never answers)
- POST/api/v1/attempts Start a Movie Mystery / Song Detective attempt
- POST/api/v1/attempts/{aid}/reveal Reveal the next clue (costs points)
- POST/api/v1/attempts/{aid}/guess Submit a guess; scoring is server-authoritative
- POST/api/v1/attempts/{aid}/share Create a spoiler-free public result link (finished attempts only)
- POST/api/v1/connections/attempts Start a Cinema Connections attempt
- POST/api/v1/connections/attempts/{aid}/submit Submit four items as a group
- POST/api/v1/battles/sessions Start a Cinema Battles session
- POST/api/v1/battles/sessions/{sid}/choice Record a pick (or skip with pick:null) and get the next pair
- GET/api/v1/battles/sessions/{sid}/ranking Personal ranking from your picks
- GET/api/v1/battles/sessions/{sid}/dna Private Cinema DNA preview
- POST/api/v1/battles/sessions/{sid}/dna Publish an approved-fields-only DNA snapshot (min 8 picks)
- GET/api/v1/me Signed-in profile summary
- GET/api/v1/me/history Recent finished games
- GET/api/v1/me/streak Daily streak (guest or account)
- POST/api/v1/me/claim Attach this device's guest history to the signed-in account
- GET/api/v1/search Search films and stars in any script
- GET/api/v1/movies/{slug} Film with titles and credits
- GET/api/v1/people/{slug} Person with filmography
- GET/api/v1/industries/{code}/films Popular films for an industry
- GET/api/v1/clubs/{slug} Club summary: followers and whether you follow
- POST/api/v1/clubs/{slug}/follow Follow (idempotent)
- DELETE/api/v1/clubs/{slug}/follow Unfollow (idempotent)
- GET/api/v1/clubs/{slug}/posts Club feed (newest first, cursor via ?before=)
- POST/api/v1/clubs/{slug}/posts Post to a club. kind labels the claim: opinion | rumor | sourced
- DELETE/api/v1/posts/{id} Author or moderator removes a post
- GET/api/v1/posts/{id}/comments Comments on a post
- POST/api/v1/posts/{id}/comments Comment on a post
- POST/api/v1/reports Report a post or comment
- GET/api/v1/i18n/{locale} UI string catalogue for a locale (shared by web and mobile)