跳转到内容
POST AI agent ready /v1/paste/get

粘贴检索 API - 免费文本片段获取

提交粘贴 ID 并接收存储的内容及其语言标签和创建时间戳。 如果粘贴已过期或不存在,则返回 404。 与 /v1/paste/create 端点结合使用。

Parameters

stringrequired

The paste ID returned by the create endpoint.

Code examples

curl -X POST https://api.botoi.com/v1/paste/get \
  -H "Content-Type: application/json" \
  -d '{"id":"f9e8d7c6"}'

When to use this API

在您的应用程序中显示带有语法突出显示的共享代码片段

获取粘贴内容和语言标签,然后使用 Prism 或 Shiki 等客户端荧光笔进行渲染。 语言标签告诉您的荧光笔要应用哪种语法。

将配置数据提取到部署脚本中

将部署配置存储为粘贴,然后通过脚本中的 ID 获取它。 这可以避免在存储库中对配置进行硬编码,同时保持其在部署窗口期间可用。

为您的开发者工具构建“查看共享片段”页面

当用户共享粘贴链接时,通过此端点获取内容并将其呈现在格式化的代码查看器中。 显示语言、创建时间和复制按钮。

Frequently asked questions

如果膏体过期了会怎样?
API 返回 404 错误,代码为 NOT_FOUND,并显示一条消息,指示粘贴未找到或已过期。
如果有 ID,任何人都可以检索粘贴吗?
是的。 对单个粘贴没有访问控制。 任何拥有 8 个字符 ID 的人都可以检索该内容。 请勿在未先加密的情况下将敏感数据存储在粘贴中。
检索粘贴是否会延长其 TTL?
不会。TTL 在创建时设置并且不会更改。 读取粘贴内容对其有效期没有影响。
粘贴 ID 是在 URL 中传递还是在请求正文中传递?
粘贴 ID 作为“id”字段在 JSON 请求正文中传递。 端点路径始终为/v1/paste/get。
我可以在一个请求中检索多个粘贴吗?
不会。每个请求都会检索一个粘贴。 要获取多个粘贴,请使用不同的 ID 发出并行请求。

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.