Aller au contenu
POST AI agent ready /v1/paste/get

API de récupération de collage - Récupération d'extraits de texte gratuits

Soumettez un identifiant de collage et recevez le contenu stocké avec sa balise de langue et son horodatage de création. Renvoie un 404 si le collage a expiré ou n'existe pas. Utilisé en combinaison avec le point de terminaison /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

Afficher des extraits de code partagés avec coloration syntaxique dans votre application

Récupérez le contenu collé et la balise de langue, puis restituez-le avec un surligneur côté client comme Prism ou Shiki. La balise de langue indique à votre surligneur quelle grammaire appliquer.

Extraire les données de configuration dans un script de déploiement

Stockez la configuration de déploiement sous forme de pâte, puis récupérez-la par ID dans votre script. Cela évite de coder en dur la configuration dans votre référentiel tout en la gardant disponible pendant toute la durée de la fenêtre de déploiement.

Créez une page « Afficher l'extrait partagé » pour votre outil de développement

Lorsqu'un utilisateur partage un lien de collage, récupérez le contenu via ce point de terminaison et affichez-le dans une visionneuse de code formaté. Affichez la langue, l'heure de création et un bouton de copie.

Frequently asked questions

Que se passe-t-il si la pâte est périmée ?
L'API renvoie une erreur 404 avec le code NOT_FOUND et un message indiquant que le collage n'a pas été trouvé ou a expiré.
N'importe qui peut-il récupérer une pâte s'il a l'identifiant ?
Oui. Il n'y a pas de contrôle d'accès sur les pâtes individuelles. Toute personne disposant de l'identifiant à 8 caractères peut récupérer le contenu. Ne stockez pas de données sensibles dans des pâtes sans les chiffrer au préalable.
La récupération d'une pâte étend-elle sa durée de vie ?
Non. La durée de vie est définie au moment de la création et ne change pas. La lecture de la pâte n'a aucun effet sur sa péremption.
L'ID de collage est-il transmis dans l'URL ou dans le corps de la requête ?
L'ID de collage est transmis dans le corps de la requête JSON en tant que champ « id ». Le chemin du point de terminaison est toujours /v1/paste/get.
Puis-je récupérer plusieurs pâtes en une seule requête ?
Non. Chaque requête récupère un seul collage. Pour récupérer plusieurs collages, effectuez des requêtes parallèles avec des ID différents.

Get your API key

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