Notas sobre APIs

Introducción a las APIs

• Definición de API: Interfaz que permite la comunicación entre aplicaciones y el intercambio de datos.
• Ejemplos de uso:
  • Aplicación tipo Uber: Integración de Google Maps para geolocalización.
  • Ecommerce: Uso de pasarelas de pago como PayPal.
  • Slack: Integración con otras aplicaciones para mejorar la funcionalidad.

Terminología en el Mundo de APIs

• Interfaz: Capa de abstracción que permite la interacción sin conocer detalles internos.
  • Ejemplo: Volante de un auto.
• API (Application Programming Interface): Interfaz para que aplicaciones se comuniquen.
• Arquitectura de Software: Diseño y organización de componentes de un sistema.
  • Servicio Web: Permite comunicación entre equipos a través de redes.

Tipos de APIs

• REST (Representational State Transfer): Permite guardar datos en caché, y definir permisos de acceso a datos.
• Formatos de envío de datos:
  • XML: Formato tradicional.
  • JSON (JavaScript Object Notation): Más utilizado hoy en día por su facilidad.
• API Públicas vs. Privadas:
  • Públicas: Acceso abierto.
  • Privadas: Requieren autenticación mediante tokens (ej. JWT).

Tipos de APIs: Locales y Remotas

• APIs Locales: Ejecutadas dentro del mismo entorno (ej. API de vibración en Android).
• APIs Remotas: Consumen datos de aplicaciones ubicadas en otras partes del mundo.

Comunicación y Protocolos

• Métodos HTTP:
  • GET: Solicitar información.
  • POST: Enviar nueva información.
  • PUT: Actualizar información existente.
  • DELETE: Borrar información.
• Códigos de Respuesta HTTP:
  • 200: Éxito.
  • 400: Solicitud inválida (ej. 404).
  • 500: Errores del servidor.

Formatos de Respuesta

• Las APIs pueden devolver información en diferentes formatos:
  • JSON (más común).
  • XML y texto plano.

Buenas Prácticas en el Desarrollo de APIs

• Autodescripción: Cada recurso debe contener información sobre otros recursos.
• Seguridad: Proteger APIs privadas para evitar accesos no autorizados.
• Testeo: Asegurarse de que la API funcione correctamente antes de su uso.
• Documentación: Importante para facilitar el consumo de la API por otros desarrolladores.

Oportunidades de Aprendizaje

• Workshop: Creación de APIs con buenas prácticas.
  • Fecha: 18 de mayo.
  • Lugar: Ciudad de México.
  • Intensivo de tres horas con detalles prácticos.
• Evento Tecnología: Ede Team en Ciudad de México, 17 y 18 de mayo.