<Hola>, vamos a realizar una pequeña API para aprender más de Python y de las API, también describiremos un poco más de ¿Qué es una API? y ¿Por qué se utiliza?, esperemos que la información les sea valiosa y práctica.
¿Qué es una API?
API son las siglas de “Application Programming Interface” o en español “Interfaz de Programación de Aplicaciones”, es una interfaz que nos permite tener una comunicación entre un cliente y el servicio de recursos, de una manera muy fácil, algunos ejemplos de API son
- API de SOAP
- Muy utilizada hace unos años
- API de RPC
- Está diseñado para realizar acciones
- API de WebSocket
- Comunicación interactiva bidireccional entre el navegador del usuario y un servidor.
- API de REST
- La más popular
La que utilizaremos es API REST, hay protocolos que seguir, aquí les dejo una liga con buenas practicas Link, no utilizaremos todos por el momento ya que estamos comenzando la aplicación, la idea es que tengamos claros los conceptos básico para luego utilizarlo en proyectos grandes, uno de estos protocolos es utilizar 4 métodos http que son:
- GET
- La más sencilla de utilizar, se utiliza para conseguir datos
- POST
- Se utiliza para guardar información
- PUT
- Se utiliza para actualizar información
- DELETE
- Se utiliza para eliminar información
¿Por qué se utiliza?
Esto es porque nos permite tener una comunicación simple y sencilla, es utilizado por grandes empresas como Google, Amazon, Facebook, entre otros; cada uno para facilitar sus servicios a los consumidores, por ejemplo, podemos obtener los datos de la analítica de Google o crear un bot en Facebook, en vez que nos den acceso directo a la base de datos, mejor, nos da una interfaz donde el cliente pueda consumir recursos y el administrador pueda delimitar las acciones de los clientes
También existen un buen número de API públicas donde puedes practicar a controlar el uso de datos.
Comenzamos con el código
Instalamos la librería Flask
pip install flask
Declaramos las librerías
from flask import Flask
from flask import jsonify
Iniciando la aplicación
#iniciamos el proyecto
app = Flask(__name__)
Creamos la función para la petición GET
#Petición con el método GET
@app.route('/', methods=['GET'])
def index():
response = {'message': 'success', 'method': 'GET'}
return jsonify(response)
Creamos la función para la petición POST
#Petición con el método POST
@app.route('/', methods=['POST'])
def index_post():
response = {'message': 'success', 'method': 'POST'}
return jsonify(response)
Creamos la función para la petición PUT
@app.route('/', methods=['PUT'])
def index_put():
response = {'message': 'success', 'method': 'PUT'}
return jsonify(response)
Creamos la función para la petición DELETE
#Petición con el metodo DELETE
@app.route('/', methods=['DELETE'])
def index_delete():
response = {'message': 'success', 'method': 'DELETE'}
return jsonify(response)
Por último declara la configuración de la aplicación
#Configuración de la aplicación
if __name__ == '__main__':
app.run(host='0.0.0.0', port=8889)
Podemos bajarnos la aplicación POSTMAN o alguna otra aplicación para realizar la pruebas, realizamos diferentes pruebas con su respuesta.
