Guías prácticas

Implementa y configura una API

• Configura Endpoints

  Se explica cómo preparar tu documento de OpenAPI para la implementación en Endpoints.

• Implemente la configuración de Endpoints

  Se describe cómo implementar un documento de OpenAPI en Endpoints.

• Implemente el backend de la API

  Explica cómo implementar el proxy de servicio extensible (ESP) y el código del backend de la API.

• Implementar en Kubernetes

  Se muestra cómo configurar y, luego, implementar Endpoints en Kubernetes.

• Ejecuta el ESP de forma local o en otra plataforma

  Muestra cómo configurar una instancia del proxy de servicio extensible en una máquina local o en otro proveedor de servicios en la nube.

• Comparar los archivos de configuración

  Describe la pestaña Historial de implementaciones en la Extremos > Página Servicios en la consola de Google Cloud y a comparar una configuración del servicio implementada con la versión anterior.

• Obtén el nombre del servicio y el ID de configuración

  Se describe cómo obtener el nombre y el ID de configuración de un servicio administrado.

Solución de problemas y supervisión

• Descripción general de la solución de problemas

  Se proporciona información general sobre la solución de problemas y vínculos a otras páginas para obtener información adicional.

• Soluciona problemas en la implementación de la configuración de Cloud Endpoints

  Se describen algunos errores que podrían surgir durante la implementación de la configuración de Endpoints y cómo solucionarlos.

• Cómo solucionar errores de respuesta

  Se describe cómo solucionar errores que recibes de una respuesta desde una solicitud a la API.

• Solucionar errores en la implementación de App Engine Flexible

  Se proporcionan técnicas para solucionar problemas con las implementaciones de Endpoints en entornos flexibles de App Engine.

• Soluciona problemas en la implementación de Compute Engine

  Se proporcionan técnicas para solucionar problemas en las implementaciones de Endpoints en Compute Engine.

• Soluciona problemas de implementación en GKE

  Se proporcionan técnicas para solucionar problemas en las implementaciones de Endpoints en GKE.

• Soluciona problemas de validación de JWT

  Ofrece información de solución de problemas en caso de que la validación del JWT falle y se muestre un error como respuesta al cliente.

• Supervisar tu API

  Se describe cómo supervisar el estado de tus API con los registros y métricas que Endpoints mantiene de forma automática.

• Haz un seguimiento de tu API

  Explica la tasa de muestreo de seguimientos, cómo estimar tu costo de Cloud Trace, cómo ver los seguimientos en la consola de Google Cloud y cómo inhabilitar el muestreo de seguimientos.

DNS y SSL

• Verifica un nombre de dominio

  Se muestra cómo verificar la propiedad de un nombre de dominio que se usará para entregar una API de Endpoints.

• Entrega una API desde tu nombre de dominio

  Se muestra cómo configurar tu proyecto para entregar solicitudes a la API.

• Configurar un DNS en el dominio cloud.goog

  Muestra cómo configurar DNS para los servicios de Endpoints que usan el dominio cloud.goog, que Google posee y administra.

• Entrega varias API desde un dominio

  Se muestra cómo ejecutar varias API independientes en tu propio dominio.

• Habilita SSL con ESP

  Se muestra cómo habilitar un puerto SSL para tu servicio de Endpoints implementado mediante el ESP.

• Habilita SSL con ESPv2

  Se muestra cómo habilitar un puerto SSL para tu servicio de Endpoints implementado mediante el ESPv2.

Autenticación y claves de API

• Elige un método de autenticación

  Proporciona una descripción general y casos prácticos de muestra para cada método de autenticación compatible.

• Por qué y cuándo usar las claves de API

  Proporciona información general sobre las claves de API y cuándo usarlas.

• Usa Firebase para autenticar usuarios

  Muestra cómo configurar tu documento de OpenAPI para que el ESP valide las solicitudes entrantes de los clientes que usan Firebase a fin de autenticar usuarios.

• Usa Auth0 para autenticar usuarios

  Muestra cómo configurar tu documento de OpenAPI para que el ESP valide las solicitudes entrantes de los clientes que usan Auth0 a fin de autenticar usuarios.

• Usa tokens de ID de Google para autenticar usuarios

  Muestra cómo configurar tu documento de OpenAPI para que el ESP valide las solicitudes entrantes de los clientes que usan tokens de ID de Google a fin de autenticar usuarios.

• Usa un método personalizado para autenticar usuarios

  Muestra cómo configurar tu documento de OpenAPI para que el ESP valide las solicitudes entrantes de los clientes que usan un proveedor personalizado a fin de autenticar usuarios.

• Autenticación entre servicios

  Muestra cómo autenticar llamadas entre servicios.

• Restringe el acceso con claves de API

  Se muestra cómo evitar que las aplicaciones y servicios de clientes no autorizados accedan a tu API.

Administra el acceso a la API

• Descripción general del acceso a la API

  Describe las opciones de control de acceso a las API a las que puedes acceder en Endpoints.

• Controla quién puede habilitar tu API

  Se muestra cómo controlar quién puede habilitar tu API en sus proyectos de Google Cloud.

• Habilita una API en tu proyecto de Google Cloud

  Muestra cómo habilitar una API en un proyecto de Google Cloud.

• Otorga y revoca el acceso a la API

  Se muestra cómo otorgar diferentes niveles de acceso para que otros miembros del equipo puedan ayudar a administrar la API.

Administración del ciclo de vida de la API

• Descripción general de la administración del ciclo de vida de las API

  Se describen las características de control de versiones de la API de Endpoints y se ofrecen prácticas recomendadas para el control de versiones y la etapa de pruebas de tu API de Endpoints.

• Borra una API y las instancias de la API

  Se muestra cómo borrar una API y las instancias de apagado que ejecutan la API a fin de evitar costos innecesarios.

• Restablece un servicio administrado

  Se muestra cómo restablecer un servicio administrado en el caso de una eliminación accidental.

Limita las solicitudes a la API (Beta)

• Acerca de las cuotas

  Se brinda una descripción general de la funcionalidad clave que proporcionan las cuotas.

• Configura cuotas

  Se describe cómo configurar cuotas para la API.

• Anula el límite de cuota predeterminado

  Se describe cómo establecer un límite de cuota diferente para un proyecto de consumidor específico.

Personaliza el ESP

• Usa un nginx.conf personalizado en GKE

  Se describe cómo crear un archivo nginx.conf personalizado para implementar ESP en GKE.

• Crea un nginx.conf personalizado para la compatibilidad con CORS

  Se muestran ejemplos de cómo se escriben las opciones de CORS de ESP en nginx.conf como punto de partida en el caso de que necesites personalizar la compatibilidad con CORS en ESP.

Otras guías prácticas de Endpoints

• Migra a ESPv2

• Guías prácticas de Endpoints Frameworks para el entorno estándar de App Engine

• Guías prácticas de Cloud Endpoints para gRPC