Freshdesk API V2 — 客服工单与联系人

官方 REST V2 可查询及管理工单、联系人、会话等客服资源，使用个人 API key 并受用户角色限制。需要实际 Freshdesk 租户域名；没有连接帮助台、读取客户数据或发送回复。

根据公开资料整理 · 尚未被提供者认领。提交者名称和样例测试不是提供者授权、本站认证或持续可用承诺。

整理进度：已整理 · 语义分类：客服工单与联系人 API · 证据等级：公开文档，未实测。

公开来源正文附件（安全文本） · 88a5719b3b6da585eaab39ef879742b0028adb9fb63384897794b211e1089dc1

文档路径以 /api/v2/... 表示，完整 URL 需实际 https://<tenant>.freshdesk.com 域名。示例采用 HTTP Basic 的 key:X 方式，API key 作为用户名、虚拟密码，并不要求把真实用户密码放进请求。列表支持 page/per_page，默认 30、上限 100，响应 Link 可给下一页。API 包含创建、更新、回复、删除、导入导出等副作用，不能作为默认只读工具。V2 是文档中的生产接口代际，部分单端点为 Beta，不是本地安装版本。

NavoNavo 是公共能力目录，保留来源、适用条件与使用说明。继续按条件查找 · 认识目录与机器入口

固定版本的深度资料

名片 cap-ffeee1f927d29cd185d5f335 · 版本 2 · 保存此版本引用

尚未深检；没有深度profile，条件保持未知，不表示不支持。

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

稳定标识: cap-ffeee1f927d29cd185d5f335
名片版本: 2
资料更新: 2026-10-24T18:47:57.3010337+00:00
原作者 / 提供者: 未知
可用状态: 未知；收录不代表正在接单或有实时库存。
本站收费: 免费；第三方条件另行核对。

输入

实际 Freshdesk 租户和个人 API key
允许的用户/坐席角色权限
具体工单/联系人标识、过滤条件、分页及写操作数据

输出

工单、联系人、会话等 JSON 资源或列表，未实际读取
创建/更新/回复等动作结果，未执行
分页 Link、配额与 Retry-After 等响应头，未实际观测

使用方式

类型: HTTP 接口
入口: 未知
HTTP 方法: GET

鉴权：API 密钥。个人 API key 经 HTTP Basic 认证，key 作为用户名、虚拟密码（如 X）；可用数据和操作取决于该 Freshdesk 用户角色。实际租户域名尚未配置。

运行前提

Freshdesk 账户、实际租户 HTTPS 域名及 API key
适合用途的角色权限
按具体接口设置过滤/分页并处理账户配额
写操作、回复与删除需明确授权，不混同只读查询

代码仓库不是正在运行的 API；网页可打开不证明业务成功。外部命令仅为资料，执行、资料分享和付费需另行授权。

第三方价格与条款

未知。API 速率依套餐，文档说明可购买额外调用；未给当前账户套餐价格、免费权限或具体额外收费。试用限流不等同免费长期服务。

未知 · 未知

资料去向

提供者服务器。客服工单、联系人、会话及附件可能含客户资料，API 在账户帮助台范围处理。本轮未读取任何此类数据；地区、日志、保留期及隐私条款未知。

限制

没有登录、读取工单/联系人、发送消息、修改或删除帮助台数据。
实际域名随租户而异，不能把文档的 domain.freshdesk.com 当作用户账户入口。
角色不允许的行为不能通过 API key 绕过；只可查看的角色不能据此回复。
每分钟配额按账户/套餐累计，与坐席数量或来源 IP 数量无关；文档称试用用户默认每分钟 50 次，但旧按小时账户可能尚未迁移，实际限额应看返回头。
无效请求及部分自定义应用也消耗配额；嵌入额外信息可能消耗多次调用。
达到限额返回 429 及 Retry-After；这里没有实施重试。
通用列表每页默认 30、最多 100；单端点特殊条件仍需核实，Beta 接口可能变更。

仍需核对

实际租户、账户权限、已迁移限流模式及计费未知。
具体工单 schema、发送/删除效果和端点兼容性未测。
没有安装版本或真实 API/业务工作流执行证据。

提交者报告的验证

仅查阅资料 · 未测试

仅读取公开来源；未调用所述工具。

日期: 2026-10-24T18:47:05.9090736+00:00
软件版本: 未知

实际检查

来源HTTPS响应可读取

未验证范围

功能、鉴权、安装、输出质量、长期可用性均未由本站测试。

公开证据

这是有条件的提交者观察。HTTP、安装、执行、输出核对和用户验收分别判断；不计算总体成功率或商业收入。

来源与贡献者

主要公开来源

Freshdesk · 公开记录 · 2026-10-24T18:47:05.9090736+00:00

提交者自述：NAVONAVO public material importer。名称未经身份核验，不等于原作者或执行方。

本次来源读取范围

{
  "url": "https://developers.freshdesk.com/api/",
  "final_url": "https://developers.freshdesk.com/api/",
  "status_code": 200,
  "title": "Freshdesk",
  "description": null,
  "checked_at": "2026-10-24T18:47:05.9090736\u002B00:00",
  "warnings": [
    "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
  ]
}

公开使用观察

暂无公开记录，不代表失败。

有依据的更正与异议

暂无公开记录，不代表失败。

补充观察或有依据的更正

通过同一公开投稿 API 或 MCP 工具提交。只发公开的必要事实，不上传私人任务、身份或凭据。提交者观察不增加商业调用和收益。

更正接口：POST /api/v1/contributions/corrections；观察接口：POST /api/v1/contributions/observations。

{
  "request_id": "replace-with-unique-request-id",
  "public_intake": true,
  "service_id": "cap-ffeee1f927d29cd185d5f335",
  "expected_version": 2,
  "changes": {
    "summary": "\u6709\u65B0\u6765\u6E90\u652F\u6301\u7684\u66F4\u6B63\u6458\u8981"
  },
  "source_urls": [
    "https://developers.freshdesk.com/api/"
  ],
  "reason": "\u8BF4\u660E\u65B0\u6765\u6E90\u652F\u6301\u54EA\u4E9B\u53D8\u66F4"
}

字段、版本冲突和观察分阶段契约 · AI 简明接入说明

完整机器记录 · 收录另一项公开能力

补充公开更正或观察

只提交获准公开的必要事实，不填写私人任务、客户资料或凭据。更正是建议，观察是有条件的提交者报告，不自动变成已核事实、商业调用或收入。

提出有来源的摘要更正

报告有条件的公开观察

结构化表单需要JavaScript；不会以其他格式自动发送。仍可使用原HTTP或MCP接口。