{ "openapi": "3.1.0", "info": { "title": "洁净雷达 Public API", "version": "3.0.0", "description": "Anonymous read-only summary lookup and citation. No API key is required. Recent items and keyword history return at most 30 results, with no continuation cursor. Refine keywords or browse the website for more. Full articles remain publicly readable on the website. Anonymous selected snapshots and change feeds are retired (410, no-store), including legacy /api/public aliases. RSS and Markdown provide summaries and reading links. Honor Cache-Control, ETag and Retry-After. Original publication and discovery dates remain distinct; verify historical standards against their original sources.", "termsOfService": "https://cleanroomradar.com/terms" }, "servers": [ { "url": "https://cleanroomradar.com" } ], "externalDocs": { "description": "Machine-readable OpenAPI document", "url": "https://cleanroomradar.com/openapi-v1.json" }, "paths": { "/api/v1/items": { "get": { "operationId": "items", "summary": "List recent public summaries", "description": "Limited public summary lookup. Returns at most 30 results; nextCursor is always null. hasMore means refine the keywords or continue reading on the website. All cursor values are rejected with 400 invalid_cursor. Website search pagination is unaffected.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "mode", "in": "query", "schema": { "type": "string", "enum": [ "selected", "all" ], "default": "selected" } }, { "name": "category", "in": "query", "schema": { "type": "string", "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ], "description": "Current values: regulation, inspection, standard, industry, tech, event." } }, { "name": "window", "in": "query", "schema": { "type": "string", "enum": [ "24h", "7d" ], "default": "7d" } }, { "name": "by", "in": "query", "schema": { "type": "string", "enum": [ "timeline", "published" ], "default": "timeline" }, "description": "Which timestamp defines the window and the ordering. 'timeline' (default) for mode=all matches what the website shows: items back-filled more than 72h after publication keep their original publication date, everything else uses the time the site received it, so slow-pushing sources still land inside a 24h window. For mode=selected, 'timeline' is the moment the item became selected (publications.selected_ready_at), newest first; each article appears once. 'published' uses the third-party publication time only, for either mode, which drops slow pushes out of short windows. Both timestamps are always returned on every item as publishedAt and discoveredAt. Item fields are unchanged." }, { "name": "q", "in": "query", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "description": "Leading and trailing whitespace is removed before validation; the remaining value must contain 2 to 200 Unicode code points." }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 } }, { "name": "cursor", "in": "query", "schema": { "type": "string" }, "description": "Retired. Any supplied cursor returns 400 invalid_cursor; omit this parameter.", "deprecated": true } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemsResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/hot-topics": { "get": { "operationId": "hotTopics", "summary": "List current multi-source hot topics", "description": "The current 洁净雷达 Top 10, ranked by multi-source coverage and discussion heat. Each item includes a one-based rank; internal and display heat values are not returned. Uses the latest successfully published ranking, normally refreshed every five minutes. Shared caches use a 60s freshness window; poll no faster than s-maxage and use If-None-Match. If an item includes links.story, it is a human-facing HTML URL: extract its final publicId path segment and call /api/v1/stories/{publicId} for timeline JSON. Never request links.story as an API. When absent, do not construct a story id.", "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HotTopicsResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" } ] } }, "/api/v1/stories/{publicId}": { "get": { "operationId": "storyByPublicId", "summary": "Get a story (event) with its coverage timeline and AI digest", "description": "One story = one real-world event aggregated from every covering source: a reverse-chronological coverage timeline, an AI digest that is rewritten incrementally as the event evolves (contradictions with earlier reporting are stated explicitly), and links to same-storyline and related stories. Extract ids from the final path segment of a hot-topics links.story HTML URL, or use ids from another story's storyline/related refs; never request links.story as JSON. Merged stories answer with a 308 to the surviving id. Call this endpoint only with an id actually returned by the API; a 404 means the public story layer or that story is unavailable.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "publicId", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 128 } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StoryResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "308": { "description": "Story was merged into another; follow Location to the surviving story id." }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/dailies": { "get": { "operationId": "dailies", "summary": "List daily-report archive entries", "description": "Date index of past daily reports, newest first. Reports are published once a day at 08:00 Asia/Shanghai, so checking this more than a few times a day is wasted work.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 30 } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DailiesResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/dailies/latest": { "get": { "operationId": "latestDaily", "summary": "Get the latest daily report", "description": "The most recent daily report, published once a day at 08:00 Asia/Shanghai. A client that only wants the daily digest should wake up shortly after 08:00 rather than poll around the clock. Agent or tool runtimes that cache a stable URL beyond HTTP cache headers should first request /api/v1/dailies?limit=1 and then fetch /api/v1/dailies/{returned-date}; never guess a date.", "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DailyResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } }, "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" } ] } }, "/api/v1/dailies/{date}": { "get": { "operationId": "dailyByDate", "summary": "Get a daily report by Shanghai calendar date", "description": "A single past daily report by Asia/Shanghai calendar date (YYYY-MM-DD). Past reports are immutable, so a client may cache them indefinitely and never re-fetch a date it already has.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "date", "in": "path", "required": true, "schema": { "type": "string", "format": "date" } } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DailyResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/selected/snapshot": { "get": { "operationId": "retiredSnapshot", "summary": "Retired anonymous selected mirror", "deprecated": true, "description": "Always returns 410, including old cursors, page tokens and conditional requests. Use summary RSS or bounded lookup; see /agent. Legacy /api/public aliases return the same response.", "responses": { "410": { "description": "Anonymous mirror retired. Cache-Control: no-store.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/selected/changes": { "get": { "operationId": "retiredChanges", "summary": "Retired anonymous selected mirror", "deprecated": true, "description": "Always returns 410, including old cursors, page tokens and conditional requests. Use summary RSS or bounded lookup; see /agent. Legacy /api/public aliases return the same response.", "responses": { "410": { "description": "Anonymous mirror retired. Cache-Control: no-store.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/history": { "get": { "operationId": "searchHistory", "summary": "Search public historical material across all dates", "description": "Limited public summary lookup. Returns at most 30 results; nextCursor is always null. hasMore means refine the keywords or continue reading on the website. All cursor values are rejected with 400 invalid_cursor. Website search pagination is unaffected.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "description": "Required keyword or standard number; after trimming, 2–200 Unicode code points." }, { "name": "category", "in": "query", "schema": { "type": "string", "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ], "description": "Current values: regulation, inspection, standard, industry, tech, event." } }, { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 30, "default": 20 } }, { "name": "cursor", "in": "query", "schema": { "type": "string", "minLength": 1, "maxLength": 2000 }, "description": "Retired. Any supplied cursor returns 400 invalid_cursor; omit this parameter.", "deprecated": true } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HistoryResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/items/{id}": { "get": { "operationId": "publicItem", "summary": "Read one public item summary by ID", "description": "Use an ID returned by current or historical search. Returns summary and original source links only, including old or deselected material still in the public pool. Missing, withdrawn, isolated, unreleased or pool-ineligible items return 404. Does not expose stored or licensed full text.", "parameters": [ { "$ref": "#/components/parameters/ActorUserAgent" }, { "$ref": "#/components/parameters/IfNoneMatch" }, { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "pattern": "^[a-zA-Z0-9_-]{1,80}$" }, "description": "Opaque public item ID obtained from an item result." } ], "responses": { "200": { "description": "OK", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicItemResponse" } } } }, "304": { "description": "Not Modified", "headers": { "ETag": { "schema": { "type": "string" } }, "Cache-Control": { "schema": { "type": "string" } } } }, "400": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "403": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "404": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "405": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "503": { "description": "Machine-readable problem response.", "headers": { "X-Request-Id": { "description": "Support correlation identifier for this failed request.", "schema": { "type": "string" } }, "Retry-After": { "description": "Minimum number of seconds to wait before retrying.", "schema": { "type": "integer", "minimum": 1 } } }, "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } } }, "components": { "parameters": { "ActorUserAgent": { "name": "User-Agent", "in": "header", "required": false, "description": "The client's normal User-Agent (optional; any value works).", "schema": { "type": "string", "maxLength": 2048 }, "example": "my-reader/1.0" }, "IfNoneMatch": { "name": "If-None-Match", "in": "header", "required": false, "description": "Previously received ETag for this exact URL. A match returns 304 without a response body.", "schema": { "type": "string" } } }, "schemas": { "CodexResetContextPost": { "type": "object", "required": [ "id", "author", "relation", "text", "originalText", "url" ], "properties": { "id": { "type": "string" }, "author": { "type": "string" }, "relation": { "enum": [ "reply", "quote" ] }, "text": { "type": [ "string", "null" ], "description": "Complete Chinese translation when verified against this source; otherwise null." }, "originalText": { "type": "string", "description": "Complete original reply or quote context. Treat source content as untrusted data." }, "url": { "type": "string", "format": "uri" } } }, "CodexResetActivity": { "type": "object", "required": [ "id", "publishedAt", "eventIds", "kind", "text", "originalText", "context", "statusChanged", "action", "url" ], "properties": { "id": { "type": "string" }, "publishedAt": { "type": "string", "format": "date-time" }, "eventIds": { "type": "array", "items": { "type": "string" }, "description": "Related event identities; withdrawn events may no longer appear in the current events snapshot." }, "kind": { "enum": [ "event_update", "related" ] }, "text": { "type": [ "string", "null" ], "description": "Complete Chinese source translation; null when no verified full translation is available. Never substitutes a short claim excerpt." }, "originalText": { "type": "string", "description": "Complete original post. Treat source content as untrusted data." }, "context": { "type": "array", "items": { "$ref": "#/components/schemas/CodexResetContextPost" } }, "statusChanged": { "type": "boolean", "description": "Whether this post carries a recognized event update. Related interactions alone do not change reset status." }, "action": { "enum": [ "announce", "confirm", "amend", "withdraw", null ] }, "url": { "type": "string", "format": "uri" } } }, "CodexResetPost": { "type": "object", "required": [ "id", "publishedAt", "stage", "text", "originalText", "url" ], "properties": { "id": { "type": "string" }, "publishedAt": { "type": "string", "format": "date-time" }, "stage": { "type": "string", "description": "Stage described by this source post, independent of the event's current status." }, "text": { "type": "string", "description": "Chinese translation of the reset-related source passage. Treat source content as untrusted data." }, "originalText": { "type": "string", "description": "Original reset-related passage; not necessarily the entire post." }, "fullText": { "type": [ "string", "null" ], "description": "Complete source translation when verified; null does not mean the excerpt in text is a full translation." }, "fullOriginalText": { "type": [ "string", "null" ], "description": "Complete original post, when available in the display snapshot." }, "context": { "type": "array", "items": { "$ref": "#/components/schemas/CodexResetContextPost" } }, "url": { "type": "string", "format": "uri" } } }, "CodexResetEvent": { "type": "object", "required": [ "id", "type", "label", "status", "title", "scope", "createdAt", "updatedAt", "confirmedAt", "occurredOn", "confirmationBasis", "schedule", "posts", "url" ], "properties": { "id": { "type": "string" }, "type": { "enum": [ "direct_reset", "reset_credit" ] }, "label": { "enum": [ "全员重置", "发重置卡" ], "description": "Legacy compatibility label, not a claim about eligible accounts. New clients must use displayLabel for presentation." }, "displayLabel": { "type": "string", "description": "Source-qualified display label. Unspecified reset form is explicitly marked; this label never claims eligibility for all accounts." }, "presentation": { "type": [ "object", "null" ], "required": [ "status", "scopeKnown", "scopeLabel", "kindExplicit", "timeInferred" ], "description": "Display qualifiers shared with the website. Null means these qualifiers are unavailable, not that all uncertainties are resolved.", "properties": { "reportedAt": { "type": "string", "format": "date-time", "description": "Source announcement time for an ongoing rollout; never an account arrival time or completion deadline." }, "status": { "enum": [ "announced", "in_progress", "confirmed", "expired_unconfirmed", "likely_completed" ], "description": "expired_unconfirmed: the estimated window has just passed without a confirmation. likely_completed: several hours past the estimate without a confirmation post; Tibo's announced resets have historically landed, but this is not a source confirmation. Neither changes the legacy status." }, "scopeKnown": { "type": "boolean", "description": "Whether cited claims specify eligible plans or audiences." }, "scopeLabel": { "type": [ "string", "null" ], "description": "Latest stated eligible plans or audiences, retaining any conditions. Prefer this qualified scope for display; null means unspecified." }, "kindExplicit": { "type": "boolean", "description": "Whether the cited source explicitly establishes the reset form." }, "timeInferred": { "type": "boolean", "description": "Whether the announced time conversion relies on an inferred timezone or date interpretation." }, "audienceZh": { "type": [ "string", "null" ], "description": "Chinese audience wording for display, e.g. 所有付费用户. Unfamiliar conditions stay quoted in the original." }, "productsZh": { "type": [ "string", "null" ], "description": "Products the reset applies to, e.g. Codex、ChatGPT Work. Not an audience." } } }, "estimate": { "type": [ "object", "null" ], "required": [ "from", "through", "basis", "label", "reason" ], "description": "Estimated landing window for an unconfirmed event, derived by the site. basis=model is the recognition model's window informed by Tibo's earlier announcements and completion posts, validated by code and never contradicting a stated time; source converts Tibo's stated time with a small delay allowance; source_day places a date-only promise in his usual Pacific evening; history uses his usual timing when no time was given. Null once confirmed. Never a source statement or an account receipt.", "properties": { "from": { "type": "string", "format": "date-time" }, "through": { "type": "string", "format": "date-time" }, "basis": { "enum": [ "model", "source", "source_day", "history" ] }, "label": { "type": "string" }, "reason": { "type": "string" } } }, "status": { "enum": [ "announced", "confirmed" ] }, "title": { "type": "string" }, "scope": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "confirmedAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Earliest confirmation post timestamp, NOT exact execution time. Null if no confirmation post exists." }, "occurredOn": { "type": [ "string", "null" ], "format": "date", "description": "Separately verified Beijing occurrence day; unknown remains null." }, "confirmationBasis": { "enum": [ "source_post", "receipt_review", null ] }, "schedule": { "type": [ "object", "null" ], "required": [ "precision", "from", "through", "label" ], "description": "Original announced time converted from Tibo's own words, retained after completion. Never an execution receipt; the site's estimate is the separate estimate field.", "properties": { "precision": { "enum": [ "exact", "approximate", "deadline", "date", "window" ] }, "from": { "type": "string", "format": "date-time" }, "through": { "type": "string", "format": "date-time" }, "label": { "type": "string" } } }, "posts": { "type": "array", "items": { "$ref": "#/components/schemas/CodexResetPost" }, "description": "Newest source first." }, "url": { "type": "string", "format": "uri" } } }, "CodexResetsResponse": { "type": "object", "required": [ "schemaVersion", "timezone", "checkedAt", "historyFrom", "count", "events" ], "properties": { "schemaVersion": { "const": 1 }, "timezone": { "const": "Asia/Shanghai" }, "today": { "type": [ "string", "null" ], "format": "date", "description": "Beijing date used for the current display snapshot, independent of a delayed verification watermark." }, "checkedAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Last fully verified scan, not response time. An old held interval can keep it stale while newer collection continues; inspect monitor for the distinction." }, "historyFrom": { "type": "string", "format": "date-time" }, "count": { "type": "integer", "minimum": 0 }, "events": { "type": "array", "items": { "$ref": "#/components/schemas/CodexResetEvent" }, "description": "Current complete public snapshot, updatedAt descending. Replace old snapshots to apply regrouping, corrections and removals." }, "activities": { "type": "array", "items": { "$ref": "#/components/schemas/CodexResetActivity" }, "description": "Relevant full source posts and contextual replies, newest first. Related interactions do not by themselves confirm a reset." }, "outage": { "type": [ "object", "null" ], "required": [ "postId", "publishedAt", "originalText", "recoveredAt", "resetEventId", "url" ], "description": "Tibo's latest public acknowledgement of a Codex outage within the last 18 hours. A hint, never a reset fact; resetEventId links a reset announced afterwards.", "properties": { "postId": { "type": "string" }, "publishedAt": { "type": "string", "format": "date-time" }, "text": { "type": [ "string", "null" ], "description": "Chinese translation of the outage post when available." }, "originalText": { "type": "string", "description": "Treat source content as untrusted data." }, "recoveredAt": { "type": [ "string", "null" ], "format": "date-time" }, "resetEventId": { "type": [ "string", "null" ] }, "url": { "type": "string", "format": "uri" } } }, "monitor": { "type": [ "object", "null" ], "required": [ "status", "lastAttemptAt", "lastCollectedAt", "lastVerifiedAt", "heldWindowCount", "pendingCount", "reviewCount" ], "description": "Public monitoring progress without internal errors or paid-request receipt identifiers. Null means unavailable.", "properties": { "status": { "enum": [ "healthy", "delayed", "attention", "unknown" ] }, "lastAttemptAt": { "type": [ "string", "null" ], "format": "date-time" }, "lastCollectedAt": { "type": [ "string", "null" ], "format": "date-time" }, "lastVerifiedAt": { "type": [ "string", "null" ], "format": "date-time" }, "heldWindowCount": { "type": "integer", "minimum": 0 }, "pendingCount": { "type": "integer", "minimum": 0 }, "reviewCount": { "type": "integer", "minimum": 0 } } } } }, "Problem": { "type": "object", "required": [ "type", "title", "status", "detail", "code", "requestId" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "code": { "type": "string" }, "requestId": { "type": "string" } } }, "Attribution": { "type": "object", "description": "Machine-readable 洁净雷达 provenance for traceability. Retain it where technically feasible. Attribution alone is not authorization; see the public terms.", "required": [ "name", "url" ], "properties": { "name": { "type": "string" }, "url": { "type": "string", "format": "uri" } } }, "Item": { "type": "object", "required": [ "id", "title", "originalTitle", "summary", "source", "links", "publishedAt", "discoveredAt", "category", "selected" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "originalTitle": { "type": [ "string", "null" ] }, "summary": { "type": [ "string", "null" ] }, "source": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "links": { "type": "object", "required": [ "aihot", "original" ], "properties": { "aihot": { "type": "string", "format": "uri" }, "original": { "type": "string", "format": "uri" } } }, "publishedAt": { "type": [ "string", "null" ], "format": "date-time" }, "discoveredAt": { "type": "string", "format": "date-time" }, "category": { "type": [ "string", "null" ], "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ], "description": "Current values: regulation, inspection, standard, industry, tech, event. Clients must tolerate future string values." }, "selected": { "type": "boolean" }, "reason": { "type": [ "string", "null" ], "description": "Reader-facing recommendation reason; null when not selected or absent." }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "contentFacts": { "$ref": "#/components/schemas/ContentFacts" }, "interpretation": { "$ref": "#/components/schemas/InterpretationSummary" }, "affiliationDisclosure": { "type": "string", "description": "Set when the original link is affiliated with this site's operator. Omitted otherwise." } } }, "ItemMinimal": { "type": "object", "required": [ "id", "title", "source", "links", "publishedAt", "discoveredAt", "category", "selected" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "source": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "links": { "type": "object", "required": [ "aihot" ], "properties": { "aihot": { "type": "string", "format": "uri" } } }, "publishedAt": { "type": [ "string", "null" ], "format": "date-time" }, "discoveredAt": { "type": "string", "format": "date-time" }, "category": { "type": [ "string", "null" ], "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ], "description": "Current values: regulation, inspection, standard, industry, tech, event. Clients must tolerate future string values." }, "selected": { "type": "boolean" } } }, "Page": { "type": "object", "required": [ "count", "hasMore", "nextCursor" ], "properties": { "count": { "type": "integer", "minimum": 0, "description": "Number of records in this page." }, "hasMore": { "type": "boolean", "description": "More matches exist. Refine the query or browse the website." }, "nextCursor": { "type": "null", "description": "Always null; machine lookup has no continuation." } } }, "ItemsResponse": { "type": "object", "required": [ "schemaVersion", "query", "items", "page" ], "properties": { "schemaVersion": { "const": 1 }, "query": { "type": "object", "required": [ "mode", "category", "window", "q", "by", "ordering" ], "properties": { "mode": { "type": "string", "enum": [ "selected", "all" ] }, "category": { "type": [ "string", "null" ], "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ], "description": "Current values: regulation, inspection, standard, industry, tech, event. Clients must tolerate future string values." }, "window": { "type": "string", "enum": [ "24h", "7d" ] }, "q": { "type": [ "string", "null" ], "minLength": 2, "maxLength": 200 }, "by": { "type": "string", "enum": [ "timeline", "published" ] }, "ordering": { "type": "string", "enum": [ "timelineDesc", "publishedAtDesc" ] } } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/Item" } }, "page": { "$ref": "#/components/schemas/Page" } } }, "HotTopic": { "type": "object", "required": [ "rank", "id", "title", "source", "links", "sourceCount", "signalCount", "sourceNames", "latestAt" ], "properties": { "rank": { "type": "integer", "minimum": 1, "maximum": 10, "description": "One-based position in the current 洁净雷达 Top 10 response." }, "id": { "type": "string" }, "title": { "type": "string" }, "source": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "links": { "type": "object", "required": [ "aihot", "original" ], "properties": { "aihot": { "type": "string", "format": "uri" }, "original": { "type": "string", "format": "uri" }, "story": { "type": "string", "format": "uri", "description": "Optional human-facing HTML URL. Extract its final publicId path segment and call /api/v1/stories/{publicId} for JSON; never request this URL as an API. Do not construct story ids when absent." } } }, "sourceCount": { "type": "integer", "minimum": 0 }, "signalCount": { "type": "integer", "minimum": 0 }, "participantCount": { "type": "integer", "minimum": 0, "description": "Distinct observed actors, unioned across editorial and signal sources; not a platform-wide population estimate." }, "sourceNames": { "type": "array", "items": { "type": "string" } }, "latestAt": { "type": "string", "format": "date-time" } } }, "HotTopicsResponse": { "type": "object", "required": [ "schemaVersion", "count", "items" ], "properties": { "schemaVersion": { "const": 1 }, "count": { "type": "integer", "minimum": 0 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/HotTopic" } } } }, "StoryReport": { "type": "object", "required": [ "id", "title", "summary", "source", "publishedAt", "links", "discoveredAt" ], "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "source": { "type": "object", "required": [ "name", "firstParty" ], "properties": { "name": { "type": "string" }, "firstParty": { "type": "boolean" } } }, "publishedAt": { "type": [ "string", "null" ], "format": "date-time" }, "links": { "type": "object", "required": [ "aihot" ], "properties": { "aihot": { "type": "string", "format": "uri" }, "original": { "type": "string", "format": "uri" } } }, "discoveredAt": { "type": "string", "format": "date-time" }, "affiliationDisclosure": { "type": "string", "description": "Set when the original link is affiliated with this site's operator. Omitted otherwise." } } }, "StoryNeighbor": { "type": "object", "required": [ "publicId", "title", "relation", "links" ], "properties": { "publicId": { "type": "string" }, "title": { "type": "string" }, "relation": { "type": "string" }, "links": { "type": "object", "required": [ "aihot", "api" ], "properties": { "aihot": { "type": "string", "format": "uri" }, "api": { "type": "string", "format": "uri" } } } } }, "Story": { "type": "object", "required": [ "publicId", "title", "status", "sourceCount", "reportCount", "firstReportAt", "latestAt", "latest", "digest", "links", "reports", "storyline", "related", "hasMore" ], "properties": { "publicId": { "type": "string" }, "title": { "type": "string" }, "status": { "enum": [ "active", "settled" ] }, "sourceCount": { "type": "integer", "minimum": 0 }, "reportCount": { "type": "integer", "minimum": 0 }, "firstReportAt": { "type": "string", "format": "date-time" }, "latestAt": { "type": "string", "format": "date-time" }, "latest": { "type": "string" }, "digest": { "type": [ "string", "null" ], "description": "Short event summary; read the complete overview on the website." }, "links": { "type": "object", "required": [ "aihot" ], "properties": { "aihot": { "type": "string", "format": "uri" } } }, "reports": { "type": "array", "items": { "$ref": "#/components/schemas/StoryReport" }, "maxItems": 30 }, "storyline": { "type": "array", "items": { "$ref": "#/components/schemas/StoryNeighbor" } }, "related": { "type": "array", "items": { "$ref": "#/components/schemas/StoryNeighbor" } }, "hasMore": { "type": "boolean", "description": "More reports are available on the website; no continuation cursor." } } }, "StoryResponse": { "type": "object", "required": [ "schemaVersion", "story" ], "properties": { "schemaVersion": { "const": 1 }, "story": { "$ref": "#/components/schemas/Story" } } }, "DailiesResponse": { "type": "object", "required": [ "schemaVersion", "count", "items" ], "properties": { "schemaVersion": { "const": 1 }, "count": { "type": "integer", "minimum": 0 }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/DailyEntry" } } } }, "DailyEntry": { "type": "object", "required": [ "date", "generatedAt", "leadTitle", "leadParagraph", "links" ], "properties": { "date": { "type": "string", "format": "date" }, "generatedAt": { "type": "string", "format": "date-time" }, "leadTitle": { "type": [ "string", "null" ] }, "leadParagraph": { "type": [ "string", "null" ] }, "links": { "type": "object", "required": [ "aihot" ], "properties": { "aihot": { "type": "string", "format": "uri" } } }, "attribution": { "$ref": "#/components/schemas/Attribution" } } }, "DailyContentLinks": { "type": "object", "required": [ "aihot", "original" ], "properties": { "aihot": { "type": [ "string", "null" ], "format": "uri" }, "original": { "type": "string", "format": "uri" } } }, "DailyReport": { "type": "object", "required": [ "date", "generatedAt", "windowStart", "windowEnd", "links", "lead", "sections", "flashes", "hasMore" ], "properties": { "date": { "type": "string", "format": "date" }, "generatedAt": { "type": "string", "format": "date-time" }, "windowStart": { "type": "string", "format": "date-time" }, "windowEnd": { "type": "string", "format": "date-time" }, "links": { "type": "object", "required": [ "aihot" ], "properties": { "aihot": { "type": "string", "format": "uri" } } }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "lead": { "anyOf": [ { "type": "object", "required": [ "title", "leadParagraph" ], "properties": { "title": { "type": "string" }, "leadParagraph": { "type": "string" } } }, { "type": "null" } ] }, "sections": { "type": "array", "items": { "type": "object", "required": [ "label", "items" ], "properties": { "label": { "type": "string" }, "items": { "type": "array", "items": { "type": "object", "required": [ "title", "summary", "source", "links" ], "properties": { "title": { "type": "string" }, "summary": { "type": "string" }, "source": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "links": { "$ref": "#/components/schemas/DailyContentLinks" }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "affiliationDisclosure": { "type": "string", "description": "Set when the original link is affiliated with this site's operator. Omitted otherwise." } } } } } } }, "flashes": { "type": "array", "items": { "type": "object", "required": [ "title", "source", "links", "publishedAt", "discoveredAt" ], "properties": { "title": { "type": "string" }, "source": { "type": "object", "required": [ "name" ], "properties": { "name": { "type": "string" } } }, "links": { "$ref": "#/components/schemas/DailyContentLinks" }, "publishedAt": { "type": [ "string", "null" ], "format": "date-time" }, "attribution": { "$ref": "#/components/schemas/Attribution" }, "discoveredAt": { "type": [ "string", "null" ], "format": "date-time", "description": "First recorded by this site; null for imported citations without local material." }, "affiliationDisclosure": { "type": "string", "description": "Set when the original link is affiliated with this site's operator. Omitted otherwise." } } } }, "hasMore": { "type": "boolean", "description": "More report items exist on the website; sections and flashes together contain at most 30 items." } } }, "DailyResponse": { "type": "object", "required": [ "schemaVersion", "report" ], "properties": { "schemaVersion": { "const": 1 }, "report": { "$ref": "#/components/schemas/DailyReport" } } }, "HistoryItem": { "allOf": [ { "$ref": "#/components/schemas/Item" }, { "type": "object", "required": [ "timelineAt" ], "properties": { "timelineAt": { "type": "string", "format": "date-time", "description": "Timeline ordering time, using the original publication date for dated backfills. This is not necessarily the publication or discovery time." } } } ] }, "HistoryResponse": { "type": "object", "required": [ "schemaVersion", "query", "items", "page" ], "properties": { "schemaVersion": { "const": 1 }, "query": { "type": "object", "required": [ "scope", "q", "category", "ordering" ], "properties": { "scope": { "const": "history" }, "q": { "type": "string" }, "category": { "type": [ "string", "null" ], "examples": [ "regulation", "inspection", "standard", "industry", "tech", "event" ] }, "ordering": { "const": "timelineDesc" } } }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/HistoryItem" } }, "page": { "$ref": "#/components/schemas/Page" } } }, "PublicItemResponse": { "type": "object", "required": [ "schemaVersion", "item" ], "properties": { "schemaVersion": { "const": 1 }, "item": { "$ref": "#/components/schemas/HistoryItem" } } }, "ContentFacts": { "type": "object", "description": "Reading aids extracted from public title/summary. Standards include explicit versions; complete source dates only. No legal current-status inference.", "properties": { "standards": { "type": "array", "items": { "type": "string" } }, "deadlines": { "type": "array", "items": { "oneOf": [ { "type": "string", "format": "date" }, { "type": "string", "format": "date-time" } ] }, "description": "A date alone is open through that Asia/Shanghai calendar day; an explicitly sourced time uses ISO date-time with +08:00. Missing times are never guessed." }, "effectiveDates": { "type": "array", "items": { "type": "string", "format": "date" } } } }, "InterpretationSummary": { "type": [ "object", "null" ], "description": "Current, published site writing metadata. Commentary and deep interpretation share the original item URL; no private evidence or model review is exposed.", "properties": { "kind": { "type": "string", "enum": [ "commentary", "deep" ] }, "origin": { "type": "string", "enum": [ "editorial", "model" ] }, "generatedAt": { "type": "string", "format": "date-time" }, "summary": { "type": [ "string", "null" ], "description": "Evidence-backed editorial judgment when available; null for authored originals without a separately stored judgment. Deep interpretations do not put their first analysis paragraph here." }, "excerpt": { "type": "string", "description": "Deep interpretations only. The first analysis paragraph, whitespace collapsed, cut to 240 Unicode code points without splitting a code point. A shorter paragraph is kept whole and is not padded from later paragraphs. Omitted when there is no analysis paragraph, and omitted on commentary because summary is already that judgment." } } } } } }