响应头
Content-Type: application/json
X-Request-Id: claude.sharedjDIpPaxMHm-000036
响应体
{"components":{"schemas":{"Error":{"properties":{"code":{"type":"string"},"details":{"description":"Optional stable diagnostic details. For schema_drift this contains redacted logical resource, column, expected/actual summary, remediation, and no physical table names or sensitive values.","type":"object"},"message":{"type":"string"},"request_id":{"description":"Request identifier also returned in the X-Request-ID response header.","type":"string"},"status":{"type":"integer"},"version":{"const":"tidbrest.error.v1","type":"string"}},"required":["version","code","message","status"],"type":"object"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/Error"}},"required":["error"],"type":"object"},"table_comments":{"properties":{"author":{"description":"varchar(128)","nullable":false,"type":"string"},"body":{"description":"text","nullable":false,"type":"string"},"created_at":{"description":"timestamp","nullable":false,"type":"string"},"id":{"description":"bigint","nullable":false,"type":"integer"},"is_internal":{"description":"tinyint(1)","nullable":false,"type":"boolean"},"task_id":{"description":"bigint","nullable":false,"type":"integer"}},"type":"object"},"table_comments_insert":{"properties":{"author":{"description":"varchar(128)","nullable":false,"type":"string"},"body":{"description":"text","nullable":false,"type":"string"},"created_at":{"description":"timestamp","nullable":false,"type":"string"},"is_internal":{"description":"tinyint(1)","nullable":false,"type":"boolean"},"task_id":{"description":"bigint","nullable":false,"type":"integer"}},"required":["task_id","body","author"],"type":"object"},"table_comments_update":{"properties":{"author":{"description":"varchar(128)","nullable":false,"type":"string"},"body":{"description":"text","nullable":false,"type":"string"},"created_at":{"description":"timestamp","nullable":false,"type":"string"},"is_internal":{"description":"tinyint(1)","nullable":false,"type":"boolean"},"task_id":{"description":"bigint","nullable":false,"type":"integer"}},"type":"object"},"table_tasks":{"properties":{"created_at":{"description":"timestamp","nullable":false,"type":"string"},"id":{"description":"bigint","nullable":false,"type":"integer"},"owner":{"description":"varchar(128)","nullable":false,"type":"string"},"priority":{"description":"int","nullable":false,"type":"integer"},"status":{"description":"varchar(32)","nullable":false,"type":"string"},"title":{"description":"varchar(255)","nullable":false,"type":"string"},"updated_at":{"description":"timestamp","nullable":false,"type":"string"}},"type":"object"},"table_tasks_insert":{"properties":{"created_at":{"description":"timestamp","nullable":false,"type":"string"},"owner":{"description":"varchar(128)","nullable":false,"type":"string"},"priority":{"description":"int","nullable":false,"type":"integer"},"status":{"description":"varchar(32)","nullable":false,"type":"string"},"title":{"description":"varchar(255)","nullable":false,"type":"string"},"updated_at":{"description":"timestamp","nullable":false,"type":"string"}},"required":["title"],"type":"object"},"table_tasks_update":{"properties":{"created_at":{"description":"timestamp","nullable":false,"type":"string"},"owner":{"description":"varchar(128)","nullable":false,"type":"string"},"priority":{"description":"int","nullable":false,"type":"integer"},"status":{"description":"varchar(32)","nullable":false,"type":"string"},"title":{"description":"varchar(255)","nullable":false,"type":"string"},"updated_at":{"description":"timestamp","nullable":false,"type":"string"}},"type":"object"}}},"info":{"description":"Minimal Faucet-derived REST API generated from published TiDB schema metadata.","title":"TiDB Schema REST MVP","version":"tidbrest.contract.v1"},"openapi":"3.1.0","paths":{"/doc":{"get":{"responses":{"200":{"description":"OpenAPI document"}},"summary":"Get OpenAPI document","tags":["Console Discovery API"],"x-tidbrest-audience":"console_discovery_api"}},"/schema":{"get":{"responses":{"200":{"description":"Published schema"}},"summary":"List published schema","tags":["Console Discovery API"],"x-tidbrest-audience":"console_discovery_api"}},"/schema/comments":{"get":{"responses":{"200":{"description":"Table schema"}},"summary":"Get comments schema","tags":["Console Discovery API"],"x-tidbrest-audience":"console_discovery_api"}},"/schema/tasks":{"get":{"responses":{"200":{"description":"Table schema"}},"summary":"Get tasks schema","tags":["Console Discovery API"],"x-tidbrest-audience":"console_discovery_api"}},"/table/comments":{"delete":{"parameters":[{"description":"Column filter for id, for example id=eq.value","in":"query","name":"id","required":false,"schema":{"type":"string"}},{"description":"Column filter for task_id, for example task_id=eq.value","in":"query","name":"task_id","required":false,"schema":{"type":"string"}},{"description":"Column filter for body, for example body=eq.value","in":"query","name":"body","required":false,"schema":{"type":"string"}},{"description":"Column filter for author, for example author=eq.value","in":"query","name":"author","required":false,"schema":{"type":"string"}},{"description":"Column filter for is_internal, for example is_internal=eq.value","in":"query","name":"is_internal","required":false,"schema":{"type":"string"}},{"description":"Column filter for created_at, for example created_at=eq.value","in":"query","name":"created_at","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Rows affected"}},"summary":"Delete comments","tags":["Public Data API"],"x-tidbrest-audience":"public_data_api","x-tidbrest-route-status":"canonical_project_data_api"},"get":{"parameters":[{"description":"Comma-separated column list","in":"query","name":"select","required":false,"schema":{"type":"string"}},{"description":"Sort expression, for example created_at.desc. Allowed order columns: author, body, created_at, id, is_internal, task_id","in":"query","name":"order","required":false,"schema":{"type":"string"}},{"description":"Maximum number of rows","in":"query","name":"limit","required":false,"schema":{"type":"string"}},{"description":"Rows to skip","in":"query","name":"offset","required":false,"schema":{"type":"string"}},{"description":"Use count=exact to include exact total count metadata","in":"query","name":"count","required":false,"schema":{"type":"string"}},{"description":"Item range header using items=start-end","in":"header","name":"Range","required":false,"schema":{"type":"string"}},{"description":"AND-only predicate expression. OR, NOT, parentheses, joins, qualified columns, functions, casts, JSON paths, aggregates, and raw SQL are unsupported.","in":"query","name":"filter","required":false,"schema":{"type":"string"}},{"description":"Column filter for id, for example id=eq.value","in":"query","name":"id","required":false,"schema":{"type":"string"}},{"description":"Column filter for task_id, for example task_id=eq.value","in":"query","name":"task_id","required":false,"schema":{"type":"string"}},{"description":"Column filter for body, for example body=eq.value","in":"query","name":"body","required":false,"schema":{"type":"string"}},{"description":"Column filter for author, for example author=eq.value","in":"query","name":"author","required":false,"schema":{"type":"string"}},{"description":"Column filter for is_internal, for example is_internal=eq.value","in":"query","name":"is_internal","required":false,"schema":{"type":"string"}},{"description":"Column filter for created_at, for example created_at=eq.value","in":"query","name":"created_at","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/table_comments"},"type":"array"}},"type":"object"}},"application/x-ndjson":{"schema":{"description":"Newline-delimited JSON; each line is one row object using the same selected columns as application/json.","type":"string"}}},"description":"Success"}},"summary":"Query comments","tags":["Public Data API"],"x-tidbrest-audience":"public_data_api","x-tidbrest-route-status":"canonical_project_data_api"},"patch":{"operationId":"update_comments","