Pular para o conteúdo
POST AI agent ready /v1/paste/get

API de recuperação de pasta - busca de trecho de texto livre

Envie um ID de colagem e receba o conteúdo armazenado junto com sua tag de idioma e carimbo de data/hora de criação. Retorna 404 se a colagem expirou ou não existe. Usado em combinação com o endpoint /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

Exibir trechos de código compartilhados com destaque de sintaxe em seu aplicativo

Obtenha o conteúdo colado e a tag de idioma e, em seguida, renderize-o com um marcador do lado do cliente, como Prism ou Shiki. A tag de idioma informa ao marcador qual gramática aplicar.

Extraia dados de configuração para um script de implantação

Armazene a configuração de implantação como uma pasta e busque-a por ID em seu script. Isso evita a configuração de codificação em seu repositório, mantendo-o disponível durante a janela de implantação.

Crie uma página "visualizar snippet compartilhado" para sua ferramenta de desenvolvedor

Quando um usuário compartilha um link de colagem, busque o conteúdo por meio desse endpoint e renderize-o em um visualizador de código formatado. Mostre o idioma, a hora de criação e um botão de copiar.

Frequently asked questions

O que acontece se a pasta expirar?
A API retorna um erro 404 com o código NOT_FOUND e uma mensagem indicando que a pasta não foi encontrada ou expirou.
Alguém pode recuperar uma pasta se tiver o ID?
Sim. Não há controle de acesso em pastas individuais. Qualquer pessoa com o ID de 8 caracteres pode recuperar o conteúdo. Não armazene dados confidenciais em pastas sem criptografá-los primeiro.
A recuperação de uma pasta estende seu TTL?
Não. O TTL é definido no momento da criação e não muda. A leitura da pasta não afeta sua validade.
O ID de colagem é passado na URL ou no corpo da solicitação?
O ID de colagem é passado no corpo da solicitação JSON como o campo "id". O caminho do terminal é sempre /v1/paste/get.
Posso recuperar várias pastas em uma solicitação?
Não. Cada solicitação recupera uma única pasta. Para buscar múltiplas pastas, faça solicitações paralelas com IDs diferentes.

Get your API key

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