SuperAPI AI 工具集

clerk-backend-api

编程与开发

查看项目

更新于 10-16 06:48

技能介绍

用途:面向 Clerk 后端 REST API(基础地址 https://api.clerk.com/v1)的探索与执行工具,支持浏览标签、查看端点 schema、发送带认证的请求,常见于列出用户、管理组织与邀请、更新用户元数据等场景。

主要能力:按标签浏览端点;查看端点请求/响应 schema;执行 GET/POST/PATCH/PUT/DELETE 请求;内置常见操作快速路径,如创建组织并邀请成员、更新用户元数据、列出近 7 天用户、删除用户。认证统一使用 Authorization: Bearer $CLERK_SECRET_KEY。

使用方式:所有请求用 curl 直接执行,例如 GET 模板 curl -s "https://api.clerk.com/v1${PATH}${QUERY_STRING}" -H "Authorization: Bearer $CLERK_SECRET_KEY";写请求加 -H "Content-Type: application/json" 与 -d '${BODY_JSON}'。可用脚本 api-specs-context.sh、extract-tags.js、extract-endpoint-detail.sh 发现端点,但不要用 scripts/execute-request.sh。支持 help、browse、execute、detail 四种模式,并可指定 --version 使用特定 spec 版本。

限制与注意:每次写请求前必须检查 CLERK_SECRET_KEY 是否设置,并检查 CLERK_BAPI_SCOPES 是否包含所需写权限,不足时先询问用户而非直接失败;DELETE 不可逆,必须明确警告并列出将销毁的数据(用户记录、所有会话、所有成员关系及关联数据),需用户确认。元数据更新为覆盖而非合并,需先读取再展开写入;REST 用 snake_case,SDK 用 camelCase。分页使用 limit 与 offset,单页上限 500。存在速率限制(生产 1000 请求/10 秒,开发 100 请求/10 秒等)。平台相关端点与 schema 应忽略。具体收费、价格与更多平台支持信息暂未提供。