Configuración de Portales para Desarrolladores en APIG

Clase 18 de 42Curso de Google Cloud Platform para E-commerce

Resumen

¿Cómo crear y personalizar un portal para desarrolladores?

La creación de un portal para desarrolladores es una herramienta esencial para interactuar con APIs. En esta lección, te mostraremos cómo establecer un portal que funcione como punto de conexión entre tus APIs y los desarrolladores que desean usarlas, ofreciéndoles la documentación necesaria y un ambiente de prueba interactivo.

¿Cuál es el proceso para crear un portal de desarrolladores?

Anteriormente, se configuró un portal llamado "Portal Platzi" en la plataforma APIG. Este portal permite a los desarrolladores:

  • Acceder a productos API mediante la integración de un catálogo personalizado.
  • Personalizar el estilo del portal usando herramientas sencillas.
  • Realizar cambios avanzados con CSS para modificar variables y añadir estilos personalizados.

¿Cómo personalizar el estilo del portal?

La personalización es clave para crear una experiencia de usuario única:

  • Logotipo: Se puede cambiar tanto el logotipo para la aplicación móvil como el icono asociado al portal.
  • Colores: Personaliza los colores del portal para que coincidan con tu branding.
  • CSS avanzado: Aquellos con experiencia en CSS pueden configurar las variables y agregar estilos personalizados desde la sección "Advanced" en APIG.

¿Cómo se visualiza el portal para desarrolladores?

Una vez configurado, los desarrolladores pueden acceder al portal y observar:

  • Logotipo y colores: Las personalizaciones que hayas implementado se verán reflejadas, mejorando la experiencia visual.
  • Catálogo de APIs: Un vistazo a los distintos productos API (como bronce, silver, gold) permite que los desarrolladores seleccionen y gestionen qué productos desean usar.

¿Cómo gestionan los desarrolladores sus API Keys?

Los desarrolladores no acceden directamente a la consola de APIG. En su lugar:

  1. Registros de apps: Los desarrolladores registran sus aplicaciones en el portal.
  2. Obtención de API Keys: Al registrar una app, el portal genera una clave API.
  3. Autorización de apps: Los desarrolladores pueden manualmente introducir la API Key o seleccionar la aplicación pre-autorizada para vincularla con las APIs disponibles.

¿Cuál es el flujo de trabajo de las operaciones de API?

Una vez que el desarrollador ha incorporado una API Key:

  • Autorización: Es vital que las aplicaciones estén correctamente autorizadas para interactuar con las APIs.
  • Ejecución de operaciones: Se puede elegir una operación y ejecutarla obteniendo el código de respuesta esperado, como el código 200.
  • Integración y documentación: El portal proporciona toda la documentación necesaria para que los desarrolladores comprendan e integren las APIs en sus propios entornos.

Recursos adicionales para el ciclo de vida de APIs

Hasta ahora, hemos cubierto desde la creación del portal hasta la interacción de los desarrolladores con las APIs. Pero para seguir aprendiendo, asegúrate de:

  • Practicar desde la creación de tu portal hasta su interacción final.
  • Examinar ejercicios adicionales que expandan tu conocimiento sobre el manejo de APIs en entornos de desarrollo.

Estos pasos no solo facilitan la interacción con las APIs, sino que también aseguran que los desarrolladores tengan la información completa y actualizada para sus necesidades. A medida que los portales para desarrolladores se vuelven más sofisticados, estas habilidades se convertirán en esenciales. ¡Anímate a seguir explorando y aprendiendo más!