{"openapi":"3.0.3","info":{"title":"Astir Watch Session API","version":"0.1.0","description":"Watch session start and stop endpoints for paired devices."},"servers":[{"url":"/","description":"Current server"}],"tags":[{"name":"Health"},{"name":"Watch Sessions"}],"components":{"securitySchemes":{"parentToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"deviceToken":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string","example":"Email is required"},"requestId":{"type":"string","example":"7d13c3a7-07d0-4f99-81a1-fb2efc42d1d8"}}}}},"LocalizedText":{"type":"object","required":["en","ru","uz"],"properties":{"en":{"type":"string","example":"Cartoons"},"ru":{"type":"string","example":"Мультфильмы"},"uz":{"type":"string","example":"Multfilmlar"}},"additionalProperties":false},"Parent":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string","example":"Parent"},"email":{"type":"string","example":"parent@example.com"},"tariff":{"type":"string","example":"free"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"Child":{"type":"object","properties":{"id":{"type":"string"},"parentId":{"type":"string"},"name":{"type":"string","example":"Child"},"birthYear":{"type":"integer","example":2018},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"WatchLimit":{"type":"object","properties":{"id":{"type":"string"},"parentId":{"type":"string"},"childId":{"type":"string"},"dailyMinutes":{"type":"integer","example":60},"allowedFrom":{"type":"string","example":"08:00"},"allowedTo":{"type":"string","example":"20:00"},"allowedDays":{"type":"array","items":{"type":"integer"},"example":[1,2,3,4,5,6,7]},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"ContentItem":{"type":"object","properties":{"id":{"type":"string","example":"bluey-001"},"title":{"$ref":"#/components/schemas/LocalizedText"},"type":{"type":"string","example":"cartoon"},"ageRating":{"type":"string","example":"G"},"durationMinutes":{"type":"integer","example":7}}},"ContentCategory":{"type":"object","properties":{"id":{"type":"string"},"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"}}},"ContentMovie":{"type":"object","properties":{"id":{"type":"string","format":"uuid","readOnly":true,"example":"7d13c3a7-07d0-4f99-81a1-fb2efc42d1d8"},"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"},"series":{"type":"array","items":{"oneOf":[{"type":"string"},{"$ref":"#/components/schemas/ContentMovie"}]}},"is_premium":{"type":"boolean","example":false},"media":{"type":"object","properties":{"has_source":{"type":"boolean","example":true},"original_name":{"type":"string","nullable":true,"example":"movie.mp4"},"mime_type":{"type":"string","nullable":true,"example":"video/mp4"},"size":{"type":"integer","nullable":true,"example":1024000}}},"playback":{"type":"object","properties":{"type":{"type":"string","example":"hls"},"status":{"type":"string","example":"pending"},"hls_url":{"type":"string","nullable":true,"example":"/media/hls/movie_id/master.m3u8"},"error":{"type":"string","nullable":true}}}}},"Tariff":{"type":"object","properties":{"id":{"type":"string","example":"free"},"code":{"type":"string","example":"free"},"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"},"is_default":{"type":"boolean","example":true},"can_watch_premium":{"type":"boolean","example":false},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"TariffStatus":{"type":"object","properties":{"tariff":{"$ref":"#/components/schemas/Tariff"},"subscription":{"nullable":true,"allOf":[{"$ref":"#/components/schemas/Subscription"}]},"access":{"type":"object","properties":{"can_watch_premium":{"type":"boolean","example":false}}}}},"Subscription":{"type":"object","nullable":true,"properties":{"id":{"type":"string"},"parentId":{"type":"string"},"tariffId":{"type":"string","example":"premium"},"provider":{"type":"string","enum":["apple","google"],"example":"apple"},"providerSubscriptionId":{"type":"string","example":"1000001234567890"},"status":{"type":"string","enum":["active","grace_period","expired","cancelled"],"example":"active"},"startedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"}}},"BillingPurchaseResponse":{"type":"object","properties":{"subscription":{"$ref":"#/components/schemas/Subscription"},"tariff":{"$ref":"#/components/schemas/Tariff"},"access":{"type":"object","properties":{"can_watch_premium":{"type":"boolean","example":true}}}}}},"responses":{"BadRequest":{"description":"Bad request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Unauthorized":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Forbidden":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"NotFound":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"Conflict":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/health":{"get":{"tags":["Health"],"summary":"Check server status","responses":{"200":{"description":"Server is running","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"}}}}}}}}},"/v1/watch-sessions/start":{"post":{"tags":["Watch Sessions"],"summary":"Start a watch session","security":[{"deviceToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["contentId"],"properties":{"contentId":{"type":"string","example":"bluey-001"}}}}}},"responses":{"201":{"description":"Watch session started","content":{"application/json":{"schema":{"type":"object","properties":{"watchSession":{"type":"object"}}}}}},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/watch-sessions/{watchSessionId}/stop":{"patch":{"tags":["Watch Sessions"],"summary":"Stop a watch session","security":[{"deviceToken":[]}],"parameters":[{"name":"watchSessionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Watch session stopped","content":{"application/json":{"schema":{"type":"object","properties":{"watchSession":{"type":"object"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}}}}