# 知乎回答评论

读取指定知乎回答的评论，返回脱敏后的完整结果。已校验采集响应结构，生产发布以独立批准为准。

ID: native-http:social.zhihu.answer.comments · Region: cn · Status: available

catalog_version: 83c87ad9840b3580bc33113a02dab0d7bbafa237a4ae58b0532143eb857a888e
updated_at: 2026-11-18T07:50:51.577352+00:00

读取指定知乎回答的评论，返回脱敏后的完整结果。已校验采集响应结构，生产发布以独立批准为准。

历史数据以数据集发布版本定义覆盖周期；实时读取反映请求时资料，不保证覆盖全部记录。

Docs: https://docs.asklear.cn/capabilities/native-http%3Asocial.zhihu.answer.comments

## POST /v1/native/social/zhihu/answers/comments

native · available · api_key, oauth

REST 支持 API Key 或 OAuth access token；MCP 需要已开放的服务及现有授权；CLI 需要已发布且包含该命令的客户端。

读取指定知乎回答的评论，返回脱敏后的完整结果。已校验采集响应结构，生产发布以独立批准为准。

按成功请求或页面计费，合法空页同价，失败不收费；具体 Credits 以当前客户价格策略及冻结报价为准。max_credits 限制本次费用，读取已保存结果不重复收费。

恢复同一次原生请求时复用原 Idempotency-Key。

### Request parameters / 请求参数

- task_query (string|null): 可选的任务归因说明。提供时，请用用户使用的语言写一句完整、简洁的 task_query，并在同一任务的发现、搜索、审批后重试、结果、导出和状态查询等调用中保持相同值。MCP 调用省略时，Asklear 记录不含用户信息的通用归因，以兼容现有客户端；REST 调用可省略并保持无归因。它是任务描述，不是任务标识。不要包含内部推理、凭据，或手机号、邮箱、身份证号、街道地址等直接个人标识。

### Synthetic request / 合成请求

```json
{
  "input": {
    "answer_id": "example"
  }
}
```

### Input schema / 输入契约

```json
{
  "$defs": {
    "Schema1": {}
  },
  "additionalProperties": false,
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "answer_id": {
          "maxLength": 256,
          "minLength": 1,
          "type": "string"
        },
        "limit": {
          "default": "20",
          "type": "string"
        },
        "offset": {
          "default": "",
          "maxLength": 8192,
          "type": "string"
        },
        "order_by": {
          "default": "score",
          "type": "string"
        }
      },
      "required": [
        "answer_id"
      ],
      "type": "object"
    },
    "max_credits": {
      "anyOf": [
        {
          "maximum": 1000000000,
          "minimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "task_query": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Optional task attribution: when provided, write one concise, self-contained task_query in the user's language and reuse that exact value in every call for the task, including discovery, search, approval retry, results, export, and status checks. For MCP calls, when omitted, Asklear records a generic non-user-specific attribution so compatible clients can still call the tool. REST calls may omit it and remain unattributed. It is a task description, not a task identifier. Do not include hidden reasoning, credentials, or direct personal identifiers such as phone numbers, email addresses, identity numbers, or street addresses.",
          "maxLength": 300
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}
```

### Response schema / 响应契约

```json
{
  "$defs": {
    "Schema1": {},
    "Schema2": {
      "properties": {
        "api_name": {
          "type": "string"
        },
        "credits_charged": {
          "minimum": 0,
          "type": "integer"
        },
        "data_projection_version": {
          "anyOf": [
            {
              "const": "business-data-v1",
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "data_recovery_status": {
          "anyOf": [
            {
              "enum": [
                "retained_receipt",
                "original_receipt_unavailable"
              ],
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "latency_ms": {
          "minimum": 0,
          "type": "integer"
        },
        "next_input": {
          "anyOf": [
            {
              "additionalProperties": false,
              "properties": {
                "answer_id": {
                  "maxLength": 256,
                  "minLength": 1,
                  "type": "string"
                },
                "limit": {
                  "default": "20",
                  "type": "string"
                },
                "offset": {
                  "default": "",
                  "maxLength": 8192,
                  "type": "string"
                },
                "order_by": {
                  "default": "score",
                  "type": "string"
                }
              },
              "required": [
                "answer_id"
              ],
              "type": "object"
            },
            {
              "type": "null"
            }
          ]
        },
        "request_id": {
          "type": "string"
        }
      },
      "required": [
        "api_name",
        "request_id",
        "latency_ms",
        "credits_charged",
        "next_input"
      ],
      "type": "object"
    }
  },
  "properties": {
    "data": {
      "additionalProperties": true,
      "description": "Additional business fields are retained; no complete field list or live sample is asserted.",
      "type": "object"
    },
    "meta": {
      "$ref": "#/$defs/Schema2"
    }
  },
  "required": [
    "data",
    "meta"
  ],
  "type": "object"
}
```

暂无已验证的实时响应样本；开放包络不表示完整字段名单。

- data (object): Additional business fields are retained; no complete field list or live sample is asserted.
- meta (object): 本次 Asklear 响应的元数据。
- meta.api_name (string): 本次响应对应的已发布能力标识。
- meta.request_id (string): Asklear 请求标识。
- meta.latency_ms (integer): 请求耗时（毫秒）。
- meta.credits_charged (integer): 本次成功响应结算的 Credits。
- meta.next_input (object|null): 存在时表示下一页经校验的 input；null 表示未提供下一页。
- meta.data_projection_version (string|null): 暂无字段说明
- meta.data_recovery_status (string|null): 暂无字段说明
- meta.next_input.answer_id (string): 暂无字段说明
- meta.next_input.limit (string): 暂无字段说明
- meta.next_input.offset (string): 暂无字段说明
- meta.next_input.order_by (string): 暂无字段说明

Follow up: GET /v1/native/results/{query_id}
读取已保存结果，不重复查询数据或收费。

### Error handling / 错误处理

#### 先判断错误来源

- 来源 HTTP 401/402/403/422 不等于您的服务密钥、余额、权限或输入有错。重新认证或充值前，先识别 native_upstream_ 主码。
- 来源 401 使用中性 Bearer realm，不透传来源认证头。
- 服务自身的鉴权、权限或输入错误，应修正后再重试。不要自动重新提交付费执行。
- HTTP 503 仅表示临时不可用。
#### 重试、重放与结算

- 已结束失败使用原键仍回放同一结果；明确重新执行须遵循 hint，使用新键及预算。
- 任务可能尚未结束：应查询原 status_url 或原任务，不要创建重复任务。HTTP 502/native_external_unknown 表示结果未确认，应继续查询原任务。
- HTTP 409/native_customer_released 是已批准的历史结算终态：零扣费、预留已释放、无需继续轮询，后续不再向客户补扣；供应商结果仍未知。
- Retry-After 只依据已验证等待证据返回；不补固定一秒或无起点的相对秒数，可信绝对截止时间在重放时递减。
- 日/月限额不代表已知重置时间。读取保存结果不会重发来源调用。
#### 未知或非法的来源响应

- 业务含义未知但有可信 HTTP 4xx/5xx 时保留实际 HTTP 状态，并使用 native_upstream_http_error_unknown。
- HTTP 200 中未知业务失败使用 502/native_upstream_unknown_business_error。
- 明确矛盾与非法来源回执分别使用 native_upstream_response_conflict 和 native_upstream_invalid_response。
- 本地映射或存储结果不可交付仍为 native_result_invalid。读取错误不会撤销原结算。
#### 来源错误码参考

来源失败使用 error.code=native_upstream_<分类> 和 error.reason=upstream_<同一分类> 识别。下表按 HTTP 状态列出错误码与含义。

- 此契约替代旧 native_unavailable/native_rate_limited 主码和较粗的 reason，客户端应按新码识别。

##### HTTP 400

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_invalid_request` | `upstream_invalid_request` | 数据来源报告请求参数错误，请联系支持核查 |
| `native_upstream_request_error` | `upstream_request_error` | 数据来源报告请求失败，具体原因尚未区分 |


##### HTTP 401

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_authentication_failed` | `upstream_authentication_failed` | 数据来源鉴权未通过，请联系支持 |


##### HTTP 402

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_payment_required` | `upstream_payment_required` | 数据来源返回支付状态，请联系支持核查 |
| `native_upstream_balance_insufficient` | `upstream_balance_insufficient` | 数据来源余额不足，请联系支持 |
| `native_upstream_request_quota_insufficient` | `upstream_request_quota_insufficient` | 数据来源可用请求次数不足，请联系支持 |
| `native_upstream_token_budget_exceeded` | `upstream_token_budget_exceeded` | 数据来源令牌预算已达上限，请联系支持 |


##### HTTP 403

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_access_denied` | `upstream_access_denied` | 数据来源或目标资源拒绝访问，请联系支持核查 |
| `native_upstream_resource_restricted` | `upstream_resource_restricted` | 数据来源限制访问该资源，请联系支持核查 |
| `native_upstream_ip_denied` | `upstream_ip_denied` | 数据来源拒绝当前出口IP，请联系支持 |
| `native_upstream_api_not_enabled` | `upstream_api_not_enabled` | 数据来源尚未开通当前接口，请联系支持 |
| `native_upstream_data_permission_denied` | `upstream_data_permission_denied` | 数据来源数据权限不足，请联系支持 |


##### HTTP 404

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_resource_not_found` | `upstream_resource_not_found` | 数据来源未找到所需资源，请联系支持核查 |


##### HTTP 422

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_validation_failed` | `upstream_validation_failed` | 数据来源未通过请求校验，请联系支持核查 |
| `native_upstream_request_rejected` | `upstream_request_rejected` | 数据来源未受理请求，请联系支持核查 |
| `native_upstream_content_rejected` | `upstream_content_rejected` | 数据来源按内容规则拒绝请求，请联系支持核查 |
| `native_upstream_unprocessable_content` | `upstream_unprocessable_content` | 数据来源无法处理请求内容，请联系支持核查 |


##### HTTP 429

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_rate_limited` | `upstream_rate_limited` | 数据来源请求速率或并发受限 |
| `native_upstream_daily_limit_exceeded` | `upstream_daily_limit_exceeded` | 数据来源每日使用限额已达上限，请联系支持 |
| `native_upstream_monthly_limit_exceeded` | `upstream_monthly_limit_exceeded` | 数据来源每月使用限额已达上限，请联系支持 |


##### HTTP 500

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_internal_error` | `upstream_internal_error` | 数据来源报告内部错误 |


##### HTTP 502

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_bad_gateway` | `upstream_bad_gateway` | 数据来源网关异常 |
| `native_upstream_fetch_failed` | `upstream_fetch_failed` | 数据来源未能采集所需数据 |
| `native_upstream_account_error` | `upstream_account_error` | 数据来源认证或额度异常，具体原因尚未区分 |
| `native_upstream_response_conflict` | `upstream_response_conflict` | 数据来源响应状态存在矛盾，请联系支持核查 |
| `native_upstream_invalid_response` | `upstream_invalid_response` | 数据来源回执格式不符合已核实契约 |
| `native_upstream_unknown_business_error` | `upstream_unknown_business_error` | 数据来源返回尚未识别的业务失败 |


##### HTTP 503

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_unavailable` | `upstream_unavailable` | 数据来源暂不可用 |


##### HTTP 504

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_timeout` | `upstream_timeout` | 数据来源响应超时 |


##### 保留已核实的实际 HTTP 4xx/5xx 状态

| error.code | error.reason | Meaning / 含义 |
| --- | --- | --- |
| `native_upstream_http_error_unknown` | `upstream_http_error_unknown` | 数据来源返回错误，具体业务原因尚未确认 |

#### 支持排查信息

- 联系支持时保留 job_id 和 request_id。
