{"openapi":"3.0.3","info":{"title":"Astir Content API","version":"0.1.0","description":"Content endpoints for parent and paired device clients."},"servers":[{"url":"/","description":"Current server"}],"tags":[{"name":"Health"},{"name":"Movies"},{"name":"Categories"}],"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/content/movies":{"get":{"tags":["Movies"],"summary":"List movies","security":[{"parentToken":[]},{"deviceToken":[]}],"responses":{"200":{"description":"Movie list","content":{"application/json":{"schema":{"type":"object","properties":{"movies":{"type":"array","items":{"$ref":"#/components/schemas/ContentMovie"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/content/movies/{movie_id}":{"get":{"tags":["Movies"],"summary":"Get one movie and prepare playback","security":[{"parentToken":[]},{"deviceToken":[]}],"parameters":[{"name":"movie_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Movie details","content":{"application/json":{"schema":{"type":"object","properties":{"movie":{"$ref":"#/components/schemas/ContentMovie"}}}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["Movies"],"summary":"Update movie title or description","security":[{"parentToken":[]}],"parameters":[{"name":"movie_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"}}}}}},"responses":{"200":{"description":"Movie updated","content":{"application/json":{"schema":{"type":"object","properties":{"movie":{"$ref":"#/components/schemas/ContentMovie"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"$ref":"#/components/responses/NotFound"}}},"delete":{"tags":["Movies"],"summary":"Delete one movie","security":[{"parentToken":[]}],"parameters":[{"name":"movie_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Movie deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","example":true},"movie":{"$ref":"#/components/schemas/ContentMovie"}}}}}},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/content/movies/{movie_id}/series":{"get":{"tags":["Movies"],"summary":"List movie series","security":[{"parentToken":[]},{"deviceToken":[]}],"parameters":[{"name":"movie_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Movie series list","content":{"application/json":{"schema":{"type":"object","properties":{"movie_id":{"type":"string"},"series":{"type":"array","items":{"$ref":"#/components/schemas/ContentMovie"}}}}}}},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}},"post":{"tags":["Movies"],"summary":"Add movie to series","security":[{"parentToken":[]}],"parameters":[{"name":"movie_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","description"],"properties":{"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"},"is_premium":{"type":"boolean","example":false}}}},"multipart/form-data":{"schema":{"type":"object","required":["metadata"],"properties":{"metadata":{"type":"string","description":"JSON with title, description, and is_premium"},"video":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Series movie added","content":{"application/json":{"schema":{"type":"object","properties":{"movie":{"$ref":"#/components/schemas/ContentMovie"},"series_item":{"$ref":"#/components/schemas/ContentMovie"}}}}}}}}},"/v1/content/movies/create":{"post":{"tags":["Movies"],"summary":"Create or upload a movie","security":[{"parentToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","description"],"properties":{"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"},"series":{"type":"array","items":{"type":"string"}},"is_premium":{"type":"boolean","example":false}}}},"multipart/form-data":{"schema":{"type":"object","required":["metadata"],"properties":{"metadata":{"type":"string","description":"JSON with title, description, series, and is_premium"},"video":{"type":"string","format":"binary"}}}}}},"responses":{"201":{"description":"Movie created","content":{"application/json":{"schema":{"type":"object","properties":{"movie":{"$ref":"#/components/schemas/ContentMovie"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"}}}},"/v1/content/categories":{"get":{"tags":["Categories"],"summary":"List content categories","security":[{"parentToken":[]},{"deviceToken":[]}],"responses":{"200":{"description":"Content category list","content":{"application/json":{"schema":{"type":"object","properties":{"categories":{"type":"array","items":{"$ref":"#/components/schemas/ContentCategory"}}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/v1/content/categories/{category_id}":{"get":{"tags":["Categories"],"summary":"Get one content category","security":[{"parentToken":[]},{"deviceToken":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Content category","content":{"application/json":{"schema":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/ContentCategory"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}},"patch":{"tags":["Categories"],"summary":"Update one content category","security":[{"parentToken":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"}}}}}},"responses":{"200":{"description":"Content category updated","content":{"application/json":{"schema":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/ContentCategory"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"},"409":{"$ref":"#/components/responses/Conflict"}}},"delete":{"tags":["Categories"],"summary":"Delete one content category","security":[{"parentToken":[]}],"parameters":[{"name":"category_id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Content category deleted","content":{"application/json":{"schema":{"type":"object","properties":{"deleted":{"type":"boolean","example":true},"category":{"$ref":"#/components/schemas/ContentCategory"}}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/content/categories/create":{"post":{"tags":["Categories"],"summary":"Create a content category","security":[{"parentToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["title","description"],"properties":{"title":{"$ref":"#/components/schemas/LocalizedText"},"description":{"$ref":"#/components/schemas/LocalizedText"}}}}}},"responses":{"201":{"description":"Content category created","content":{"application/json":{"schema":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/ContentCategory"}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"409":{"$ref":"#/components/responses/Conflict"}}}}}}