cómo los programas de computadora se comunican entre sí? La respuesta está en las APIs. En este artículo, aprenderás cómo crear y consumir APIs utilizando Python. Te guiaremos paso a paso, con ejemplos prácticos, para que puedas poner en práctica lo aprendido de inmediato.
¿Qué es una API?
Una API (Application Programming Interface) es un conjunto de reglas y definiciones que permite que dos aplicaciones se comuniquen entre sí. Imagina que es un mensajero que lleva tus solicitudes a otro programa y te trae las respuestas.
¿Por Qué Usar Python para Crear APIs?
Python es un lenguaje de programación popular por su simplicidad y poder. Es ideal para crear APIs debido a sus bibliotecas y frameworks robustos, como Flask, que facilitan el desarrollo rápido y eficiente.
Creando una API en Python con Flask
Instalando Flask
Primero, necesitas instalar Flask. Abre tu terminal y escribe:
pip install Flask
Escribiendo el Código de la API
Crea un archivo llamado app.py y agrega el siguiente código:
from flask import Flask, jsonify, request
app = Flask(__name__)
@app.route('/api/saludo', methods=['GET'])
def saludo():
nombre = request.args.get('nombre', 'Mundo')
return jsonify({'mensaje': f'Hola, {nombre}!'})
@app.route('/api/sumar', methods=['GET'])
def sumar():
a = request.args.get('a', default=0, type=int)
b = request.args.get('b', default=0, type=int)
return jsonify({'resultado': a + b})
if __name__ == '__main__':
app.run(debug=True)
Explicación del Código
- Importar Flask: Importamos las funciones necesarias de Flask.
- Crear la Aplicación:
app = Flask(__name__)crea una instancia de la aplicación Flask. - Definir Rutas:
/api/saludo: Devuelve un saludo personalizado./api/sumar: Suma dos números y devuelve el resultado.
- Ejecutar la Aplicación:
app.run(debug=True)ejecuta la aplicación en modo debug.
Ejecutando la API
Para ejecutar la API, abre tu terminal y escribe:
python app.pyTu API estará disponible en http://127.0.0.1:5000.
Consumiendo una API desde un Cliente Web
Ahora que tienes tu API en funcionamiento, veamos cómo consumirla desde un cliente web utilizando JavaScript.
Creando el Cliente Web
Crea un archivo llamado index.html y agrega el siguiente contenido:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Consumiendo API en Python</title>
</head>
<body>
<h1>Consumiendo API en Python con Flask</h1>
<div>
<h2>Saludo</h2>
<input type="text" id="nombre" placeholder="Introduce tu nombre">
<button onclick="obtenerSaludo()">Obtener Saludo</button>
<p id="saludo"></p>
</div>
<div>
<h2>Sumar Números</h2>
<input type="number" id="numero1" placeholder="Número 1">
<input type="number" id="numero2" placeholder="Número 2">
<button onclick="sumarNumeros()">Sumar</button>
<p id="resultado"></p>
</div>
<script>
function obtenerSaludo() {
const nombre = document.getElementById('nombre').value;
fetch(`http://127.0.0.1:5000/api/saludo?nombre=${nombre}`)
.then(response => response.json())
.then(data => {
document.getElementById('saludo').innerText = data.mensaje;
})
.catch(error => console.error('Error:', error));
}
function sumarNumeros() {
const numero1 = document.getElementById('numero1').value;
const numero2 = document.getElementById('numero2').value;
fetch(`http://127.0.0.1:5000/api/sumar?a=${numero1}&b=${numero2}`)
.then(response => response.json())
.then(data => {
document.getElementById('resultado').innerText = `Resultado: ${data.resultado}`;
})
.catch(error => console.error('Error:', error));
}
</script>
</body>
</html>
Probando la Aplicación
- Ejecuta tu servidor Flask (si no está ya en ejecución) con
python app.py. - Abre el archivo
index.htmlen tu navegador web. - Prueba introduciendo tu nombre en el campo de saludo y presionando el botón «Obtener Saludo».
- Prueba sumando dos números en los campos correspondientes y presionando el botón «Sumar».
Conclusión
Crear y consumir APIs en Python es más sencillo de lo que parece, especialmente con herramientas como Flask. Ya sea que estés desarrollando en un entorno Linux o cualquier otro sistema operativo, Python te ofrece la flexibilidad y el poder para crear aplicaciones robustas y eficientes. Ahora que sabes cómo hacerlo, ¡pon manos a la obra y empieza a desarrollar tus propias APIs en Python!
Este artículo te ha mostrado los conceptos básicos y ejemplos prácticos para que puedas empezar. ¡Sigue explorando y aprendiendo para mejorar tus habilidades en desarrollo de software!