AI代理的API指南

基础URL和请求格式

请求使用 https://seohabit.com/api/v1。发送 JSON 请求体时使用 Content-Type: application/json。网站项目和自动提交进度需要身份验证。请求有频率限制。

跟踪第三方提交

创建包含授权目录详情的项目以启用向合格提供商的自动提交。每天最多尝试两次，最多在五个已确认目录后停止。SEOHabit在后台选择合格目录，用户无需浏览或选择目录列表。若无合格提供商，项目将等待。确认不等于发布或已验证的回链。

轮询任务状态

轮询状态 URL，直到任务达到 completed 或 failed。每次轮询均需使用任务的访问令牌在请求头中进行身份验证。任务令牌仅授予其自身任务的访问权限。

curl 'https://seohabit.com/api/v1/jobs/job_example' \
  -H 'X-Access-Token: YOUR_JOB_ACCESS_TOKEN'

响应内容包括 queued, running, completed, 或 failed; result 在可用前为空。

账户、项目密钥和付费操作

账户注册和登录会设置一个HttpOnly sh_session Cookie。浏览器Cookie写入操作将进行源检查。对于集成场景，已登录账户可为项目范围创建带有明确范围的API密钥，并以Authorization: Bearer shk_…形式发送。密钥无法访问其他项目，且密钥范围限制可用操作。请妥善保管会话Cookie和API密钥，切勿在URL中包含。

关键词任务接受 details.keyword，可选 details.language（默认值为 en）以及可选的明确 details.pageUrl。建议会展示匹配页面的证据，并标记未知语言或搜索需求。

网站审计可在免费项目内按免费配额排队。监控回链、任务创建和任务执行需要已验证的网站和有效订阅。付费操作需由人员确认所有权，并通过账户账单流程明确获取订阅。不得代他人启动结算、订阅或授权网站变更。任务执行不能证明变更已应用；待处理任务需用户审核和确认后方可生效。

项目密钥支持 project:read, project:write, checks:write, 和 tasks:write。每个密钥仅适用于其所属项目。详情请参见 OpenAPI 文档 中的路由和请求格式说明。

错误与安全使用

错误响应使用JSON格式，包含error和message。常见响应包括400（无效输入或不安全的URL）、401（缺少账户认证）、403（被禁止的来源或范围）、404（资源不可用）、409（冲突）、429（速率限制）和402（付费操作需有效订阅）。

仅检查您被授权查看的公开页面。服务会阻止对私有和本地网络目标的访问，并在可用情况下遵循源站点的爬虫策略。对于可重试的POST请求，请使用幂等键，遇到速率限制响应时应使用退避策略。