Comment créer des pastes par programmation : Guide d'intégration API

PasteTemp propose une API REST propre qui permet aux développeurs de créer, récupérer et gérer des pastes par programmation. Que vous construisiez des pipelines CI/CD, que vous intégriez le partage de paste dans votre application ou que vous automatisiez des flux de travail de reporting, l'API offre toutes les fonctionnalités disponibles via l'interface web.

L'API est conçue autour de principes RESTful avec des URL orientées ressources prévisibles, des méthodes HTTP standard et des formats de requête et de réponse JSON. L'authentification est gérée via des clés API, disponibles pour les utilisateurs premium dans les paramètres de leur compte.

Pour commencer, vous avez besoin d'une clé API depuis votre page de paramètres de compte PasteTemp (fonctionnalité premium). Une fois que vous avez votre clé, vous pouvez envoyer des requêtes à l'URL de base https://api.pastetemp.com/v1. Toutes les requêtes doivent inclure la clé API dans l'en-tête Authorization.

Créer un paste est une simple requête POST. Vous envoyez le contenu, le délai d'expiration en minutes et, facultativement, un mot de passe. L'API renvoie un identifiant de paste unique et l'URL partageable. Voici un exemple curl : curl -X POST https://api.pastetemp.com/v1/pastes -H 'Authorization: Bearer YOUR_API_KEY' -H 'Content-Type: application/json' -d '{"content": "Hello World", "expires_in": 5}'. La réponse inclut l'identifiant et l'URL du paste.

Récupérer un paste est tout aussi simple avec une requête GET vers le point de terminaison de l'identifiant du paste. L'API renvoie le contenu du paste, l'heure de création, l'heure d'expiration et le nombre de vues. Pour les pastes protégés par mot de passe, vous devez inclure le mot de passe dans le corps de la requête.

La gestion des erreurs suit les conventions HTTP standard. Une réponse 200 indique le succès, 400 indique une requête incorrecte (champs requis manquants), 401 indique un échec d'authentification, 404 indique que le paste est introuvable ou a expiré, et 429 indique une limitation de débit. Chaque réponse d'erreur inclut un message descriptif pour faciliter le débogage.

La limitation de débit est appliquée par clé API : 100 requêtes par heure pour le plan Mensuel Basic, 500 par heure pour le plan Annuel et 1000 par heure pour le plan à vie. Les en-têtes de réponse incluent X-RateLimit-Remaining et X-RateLimit-Reset pour surveiller l'utilisation.

Pour les développeurs JavaScript, voici une intégration simple utilisant fetch : const response = await fetch('https://api.pastetemp.com/v1/pastes', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ content: 'Hello from JavaScript!', expires_in: 10 }) }); const data = await response.json(); console.log(data.url);

L'API est conçue pour être suffisamment simple pour des scripts rapides tout en étant assez puissante pour une intégration en production. Que vous soyez un développeur solo automatisant votre flux de travail ou une équipe intégrant le partage de paste dans vos outils, l'API PasteTemp offre les fonctionnalités dont vous avez besoin avec une surcharge minimale.