ডেভেলপারদের জন্য
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)