SuperAPI AI 工具集

yourwebs

通用与其它

查看项目

更新于 10-16 06:43

技能介绍

用途:将单个自包含 HTML 文件托管到 yourweb,获得公开的全屏 URL,适合发布页面或 artifact。

主要能力:REST API 支持发布页面,以及列出、获取、更新、删除自己拥有的页面。两个域名分工:yourwebs.cc 是仪表盘和 REST API(https://yourwebs.cc/api/v1);yourwebs.app 用于提供已发布页面,子域名为 my-page 的页面地址是 https://my-page.yourwebs.app。

使用方式:除匿名发布外,每次调用都需要 bearer token(ywb_...),由用户在 yourweb 仪表盘生成。token 从环境变量 YOURWEBS_API_TOKEN 读取,不要硬编码、写入文件或回显。若未设置,应停止并请用户设置:export YOURWEBS_API_TOKEN="ywb_..."。发布时准备单个自包含 HTML 文件(内联 CSS/JS,无外部构建),须为 UTF-8、包含 <!doctype html> 或 <html>、不超过 1 MB;用 jq 构建 JSON 后 POST 到 /pages,返回的 url 交给用户。title 和 subdomain 可选,subdomain 仅在带 token 时生效,须为 3–32 字符的小写 a-z、0-9、-,不能有首尾或连续连字符,不能是保留字;省略则随机分配。管理接口:GET /pages 列出、GET /pages/:id 获取、PUT /pages/:id 替换 HTML、DELETE /pages/:id 删除,均需 token。

限制:HTML 不合法返回 400 invalid_html;子域格式错误返回 400 subdomain_invalid;子域被占用返回 409 subdomain_taken;发布限 30 次/小时,更新限 60 次/小时,429 时应等待后重试。匿名页面 30 天后自动删除且无法认领,需保留的页面应带 token 发布。错误格式为 { "error": { "code": "...", "message": "..." } }。完整契约见 reference/api.md。