{"openapi":"3.1.0","info":{"title":"Hospitality Intelligence Platform","version":"0.1.0"},"paths":{"/api/v1/keys/request":{"post":{"summary":"Request Key","operationId":"request_key_api_v1_keys_request_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/keys/issue":{"post":{"summary":"Issue Key","operationId":"issue_key_api_v1_keys_issue_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeyIssue"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/me":{"get":{"summary":"Get Me","operationId":"get_me_api_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/admin/keys":{"get":{"summary":"Admin List Keys","operationId":"admin_list_keys_api_v1_admin_keys_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/admin/keys/{prefix}/revoke":{"post":{"summary":"Admin Revoke Key","operationId":"admin_revoke_key_api_v1_admin_keys__prefix__revoke_post","parameters":[{"name":"prefix","in":"path","required":true,"schema":{"type":"string","title":"Prefix"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/admin/keys/{prefix}/unfreeze":{"post":{"summary":"Admin Unfreeze Key","operationId":"admin_unfreeze_key_api_v1_admin_keys__prefix__unfreeze_post","parameters":[{"name":"prefix","in":"path","required":true,"schema":{"type":"string","title":"Prefix"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articles":{"get":{"summary":"List Api Articles","operationId":"list_api_articles_api_v1_articles_get","parameters":[{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}},{"name":"tag","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^(en|zh|both)$","default":"both","title":"Lang"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":1,"title":"Page"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/articles/{slug}":{"get":{"summary":"Get Api Article","operationId":"get_api_article_api_v1_articles__slug__get","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","title":"Slug"}},{"name":"lang","in":"query","required":false,"schema":{"type":"string","pattern":"^(en|zh|both)$","default":"both","title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/changes":{"get":{"summary":"Get Changes","operationId":"get_changes_api_v1_changes_get","parameters":[{"name":"since","in":"query","required":true,"schema":{"type":"string","title":"Since"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/categories":{"get":{"summary":"List Api Categories","operationId":"list_api_categories_api_v1_categories_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/search":{"get":{"summary":"Search Api","operationId":"search_api_api_v1_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/openapi.json":{"get":{"summary":"Api Openapi","operationId":"api_openapi_api_v1_openapi_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AISummaryRequest":{"properties":{"content_zh":{"type":"string","title":"Content Zh"},"content_en":{"type":"string","title":"Content En"},"title_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Zh","default":""},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En","default":""}},"type":"object","required":["content_zh","content_en"],"title":"AISummaryRequest"},"ArticleCreate":{"properties":{"title_zh":{"type":"string","title":"Title Zh"},"title_en":{"type":"string","title":"Title En"},"excerpt_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt Zh","default":""},"excerpt_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt En","default":""},"content_zh":{"type":"string","title":"Content Zh"},"content_en":{"type":"string","title":"Content En"},"category_slug":{"type":"string","title":"Category Slug"},"author_name":{"type":"string","title":"Author Name"},"author_name_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name Zh","default":""},"author_title_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Title Zh","default":""},"author_title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Title En","default":""},"author_avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Avatar","default":""},"cover_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image","default":""},"tags":{"items":{"type":"string"},"type":"array","title":"Tags","default":[]},"is_featured":{"type":"boolean","title":"Is Featured","default":false},"is_pinned":{"type":"boolean","title":"Is Pinned","default":false},"is_premium":{"type":"boolean","title":"Is Premium","default":false},"is_published":{"type":"boolean","title":"Is Published","default":true},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"publish_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish At"},"geo_core_problem_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Core Problem Zh","default":""},"geo_core_problem_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Core Problem En","default":""},"geo_theoretical_solution_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Theoretical Solution Zh","default":""},"geo_theoretical_solution_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Theoretical Solution En","default":""},"geo_empirical_metric_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Empirical Metric Zh","default":""},"geo_empirical_metric_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Empirical Metric En","default":""},"original_source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Url","default":""},"original_source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Name","default":""},"original_source_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Date","default":""}},"type":"object","required":["title_zh","title_en","content_zh","content_en","category_slug","author_name"],"title":"ArticleCreate"},"ArticleUpdate":{"properties":{"title_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Zh"},"title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title En"},"title_ru":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title Ru"},"excerpt_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt Zh"},"excerpt_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt En"},"excerpt_ru":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Excerpt Ru"},"content_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content Zh"},"content_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content En"},"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug"},"author_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name"},"author_name_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Name Zh"},"author_title_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Title Zh"},"author_title_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Title En"},"author_avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Avatar"},"cover_image":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cover Image"},"tags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Tags"},"is_featured":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Featured"},"is_pinned":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Pinned"},"is_premium":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Premium"},"is_published":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Published"},"is_archived":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Archived"},"publish_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Publish At"},"slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Slug"},"aliases":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Aliases"},"geo_core_problem_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Core Problem Zh"},"geo_core_problem_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Core Problem En"},"geo_theoretical_solution_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Theoretical Solution Zh"},"geo_theoretical_solution_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Theoretical Solution En"},"geo_empirical_metric_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Empirical Metric Zh"},"geo_empirical_metric_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Geo Empirical Metric En"},"original_source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Url"},"original_source_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Name"},"original_source_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original Source Date"},"dateModified":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Datemodified"},"mentions":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Mentions"}},"type":"object","title":"ArticleUpdate"},"Body_upload_file_api_upload_post":{"properties":{"file":{"type":"string","format":"binary","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_file_api_upload_post"},"BulkCommentAction":{"properties":{"ids":{"items":{"type":"string"},"type":"array","title":"Ids"}},"type":"object","required":["ids"],"title":"BulkCommentAction"},"CategoryCreate":{"properties":{"slug":{"type":"string","title":"Slug"},"name_zh":{"type":"string","title":"Name Zh"},"name_en":{"type":"string","title":"Name En"},"description_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Zh","default":""},"description_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description En","default":""},"order":{"type":"integer","title":"Order","default":0}},"type":"object","required":["slug","name_zh","name_en"],"title":"CategoryCreate"},"CategoryUpdate":{"properties":{"name_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name Zh"},"name_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name En"},"description_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Zh"},"description_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description En"},"order":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Order"}},"type":"object","title":"CategoryUpdate","description":"Partial update for a category — slug is intentionally NOT updatable."},"CheckoutCreate":{"properties":{"email":{"type":"string","title":"Email"},"origin_url":{"type":"string","title":"Origin Url"},"plan":{"type":"string","title":"Plan","default":"annual"}},"type":"object","required":["email","origin_url"],"title":"CheckoutCreate"},"CommentCreate":{"properties":{"article_id":{"type":"string","title":"Article Id"},"author_name":{"type":"string","title":"Author Name"},"author_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Author Email","default":""},"content":{"type":"string","title":"Content"},"parent_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Parent Id"}},"type":"object","required":["article_id","author_name","content"],"title":"CommentCreate"},"FingerprintUpload":{"properties":{"lang":{"type":"string","title":"Lang"},"batch_id":{"type":"string","title":"Batch Id"},"variants":{"items":{"$ref":"#/components/schemas/FingerprintVariant"},"type":"array","title":"Variants"}},"type":"object","required":["lang","batch_id","variants"],"title":"FingerprintUpload"},"FingerprintVariant":{"properties":{"uid":{"type":"integer","minimum":0.0,"title":"Uid"},"content":{"type":"string","title":"Content"}},"type":"object","required":["uid","content"],"title":"FingerprintVariant"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"KeyIssue":{"properties":{"email":{"type":"string","title":"Email"},"token":{"type":"string","title":"Token"}},"type":"object","required":["email","token"],"title":"KeyIssue"},"KeyRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"KeyRequest"},"LoginInput":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"}},"type":"object","required":["email","password"],"title":"LoginInput"},"NewsletterSend":{"properties":{"subject_zh":{"type":"string","title":"Subject Zh"},"subject_en":{"type":"string","title":"Subject En"},"intro_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intro Zh","default":""},"intro_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Intro En","default":""},"article_ids":{"items":{"type":"string"},"type":"array","title":"Article Ids"}},"type":"object","required":["subject_zh","subject_en","article_ids"],"title":"NewsletterSend"},"SubscribeRequest":{"properties":{"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":""},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","default":""},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","default":""},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country","default":""},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City","default":""},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","default":""},"phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Phone","default":""},"source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source","default":""},"topics":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Topics"},"utm":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Utm"}},"type":"object","required":["email"],"title":"SubscribeRequest"},"UserCreate":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","title":"Password"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role","default":"contributor"},"bio_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio Zh","default":""},"bio_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio En","default":""},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar","default":""}},"type":"object","required":["email","password","name"],"title":"UserCreate"},"UserUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"bio_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio Zh"},"bio_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bio En"},"avatar":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar"},"password":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Password"}},"type":"object","title":"UserUpdate"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VideoCreate":{"properties":{"title_zh":{"type":"string","title":"Title Zh"},"title_en":{"type":"string","title":"Title En"},"description_zh":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description Zh","default":""},"description_en":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description En","default":""},"video_url":{"type":"string","title":"Video Url"},"thumbnail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Thumbnail","default":""},"category_slug":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category Slug","default":""},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration","default":""},"is_published":{"type":"boolean","title":"Is Published","default":true}},"type":"object","required":["title_zh","title_en","video_url"],"title":"VideoCreate"},"WhitepaperRequest":{"properties":{"email":{"type":"string","title":"Email"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name","default":""},"company":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company","default":""},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role","default":""},"whitepaper_slug":{"type":"string","title":"Whitepaper Slug"},"utm":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Utm"}},"type":"object","required":["email","whitepaper_slug"],"title":"WhitepaperRequest"}},"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-API-Key"}}}}