Cómo crear pastes mediante programación: Guía de integración API

PasteTemp ofrece una API REST limpia que permite a los desarrolladores crear, recuperar y gestionar pastes mediante programación. Ya sea que estés construyendo pipelines de CI/CD, integrando compartir paste en tu aplicación o automatizando flujos de trabajo de reportes, la API proporciona toda la funcionalidad disponible a través de la interfaz web.

La API está diseñada en torno a principios RESTful con URLs orientadas a recursos predecibles, métodos HTTP estándar y formatos de solicitud y respuesta JSON. La autenticación se maneja mediante claves API, que están disponibles para usuarios premium en la configuración de su cuenta.

Para empezar, necesitas una clave API desde tu página de configuración de cuenta de PasteTemp (funcionalidad premium). Una vez que tengas tu clave, puedes hacer solicitudes a la URL base https://api.pastetemp.com/v1. Todas las solicitudes deben incluir la clave API en el encabezado Authorization.

Crear un paste es una simple solicitud POST. Envías el contenido, el tiempo de expiración en minutos y, opcionalmente, una contraseña. La API devuelve un ID de paste único y la URL compartible. Aquí hay un ejemplo con 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 respuesta incluye el ID y la URL del paste.

Recuperar un paste es igualmente sencillo con una solicitud GET al endpoint del ID del paste. La API devuelve el contenido del paste, la hora de creación, la hora de expiración y el contador de visitas. Para los pastes protegidos por contraseña, debes incluir la contraseña en el cuerpo de la solicitud.

El manejo de errores sigue las convenciones HTTP estándar. Una respuesta 200 indica éxito, 400 indica una solicitud incorrecta (campos requeridos faltantes), 401 indica un fallo de autenticación, 404 indica que el paste no se encontró o ha expirado, y 429 indica limitación de tasa. Cada respuesta de error incluye un mensaje descriptivo para ayudar con la depuración.

La limitación de tasa se aplica por clave API: 100 solicitudes por hora para el plan Mensual Basic, 500 por hora para Anual y 1000 por hora para los planes Lifetime. Los encabezados de respuesta incluyen X-RateLimit-Remaining y X-RateLimit-Reset para monitorear el uso.

Para desarrolladores de JavaScript, aquí hay una integración simple usando 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);

La API está diseñada para ser lo suficientemente simple para scripts rápidos y lo suficientemente potente para integración en producción. Ya seas un desarrollador individual automatizando tu flujo de trabajo o un equipo integrando compartir paste en tus herramientas, la API de PasteTemp proporciona la funcionalidad que necesitas con una sobrecarga mínima.