---
title: "Mejores prácticas para construir APIs confiables - API7.ai"
description: "Este artículo analiza las mejores prácticas para diseñar APIs confiables, presentándote un proxy inverso especial: el API Gateway."
url: "https://api7.ai/es/blog/best-practices-for-building-reliable-apis-with-api-gateways"
---

[Blog](https://api7.ai/es/blog)

[Products](https://api7.ai/es/category/products)[Technology](https://api7.ai/es/category/technology)[Ecosystem](https://api7.ai/es/category/ecosystem)[Case Study](https://api7.ai/es/category/usercase)[Team & Community](https://api7.ai/es/category/community)

Search

⌘ + K

[Blog](https://api7.ai/blog)

Technology

# Mejores prácticas para construir APIs confiables

[![Navendu Pottekkat](https://avatars.githubusercontent.com/u/49474499?v=4)](https://github.com/pottekkat)

[Navendu Pottekkat](https://github.com/pottekkat)

August 18, 2022

[Technology](https://api7.ai/category/technology)

A medida que tus APIs escalan, la necesidad de hacerlas confiables y robustas aumenta.

Este artículo discute las mejores prácticas para construir APIs confiables introduciendo un tipo especial de proxies inversos llamados API gateways.

Veremos:

1. Problemas con los diseños tradicionales de APIs
2. Qué son los API gateways
3. Cómo los API gateways mejoran las APIs y
4. Patrones y ejemplos usando API gateways

Pero primero, ¿qué son las APIs "confiables"?

## ¿Qué hace que una API sea confiable?

Como proveedor de servicios, podrías tener acuerdos de nivel de servicio (SLAs) con tus clientes, usualmente expresados en tiempo de actividad (uptime)—la cantidad de tiempo que el servicio está garantizado para estar en línea y operativo.

El tiempo de actividad es una visión miope de la confiabilidad. Para entender lo que significa ser confiable, debes mirar los factores que afectan el tiempo de actividad. Una vez que entiendas estos factores, estarás en una mejor posición para construir servicios confiables.

Veamos estos factores y las preguntas que plantean:

1. **Latencia**: ¿Qué tan rápido responde tu API a las solicitudes?
2. **Seguridad**: ¿Quién puede acceder a tu API? ¿Es segura?
3. **Frecuencia de caídas**: ¿Con qué frecuencia está caída tu API?
4. **Consistencia**: ¿Son constantes los endpoints de tu API? ¿Necesitan los consumidores cambiar su código con frecuencia?
5. **Monitoreo y reportes**: ¿Puedes observar problemas y fallas en tu API? ¿Los estás reportando a tus consumidores?

![network error/api.png](https://static.api7.ai/2022/blog/0819/2022-08-19-084123.png?imageMogr2/format/webp)

A medida que las organizaciones se mueven hacia arquitecturas nativas de la nube, se vuelve difícil para los equipos de desarrollo tener en cuenta estos factores en cada uno de sus servicios. Y a medida que estos sistemas escalan, sería mucho más fácil delegar estas responsabilidades a un sistema único y separado. *¡Dale la bienvenida a los API gateways!*

## API Gateway, el punto de entrada unificado

Un [API gateway](https://api7.ai/blog/apisix-vs-kong-3-0) actúa como intermediario entre tus clientes y tus APIs. Aceptará todo el [tráfico](https://api7.ai/blog/traffic-split-in-apache-apisix-ingress-controller) (llamadas API) como los proxies inversos, reenvía la solicitud a los servicios requeridos en tu backend y devuelve los resultados necesarios.

![network error/api gateway.png](https://static.api7.ai/2022/blog/0819/2022-08-19-101223.png?imageMogr2/format/webp)

Un API gateway puede ser el punto central que maneja todas las preocupaciones de [autenticación](https://api7.ai/blog/api-gateway-authentication), seguridad, control de tráfico y monitoreo, permitiendo que los desarrolladores de APIs se concentren en las necesidades del negocio y facilitando la mejora de la confiabilidad.

![network error/api gateway reliability.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093336.png?imageMogr2/format/webp)

Hay muchas [ofertas de API gateways de código abierto y gestionados](https://geekflare.com/api-gateway/) disponibles. En este artículo, estaré usando [Apache APISIX](https://apisix.apache.org/).

La siguiente sección describirá algunas de las mejores prácticas para hacer tus APIs confiables usando API gateways.

## Mejores prácticas de confiabilidad con API gateways

Nos enfocaremos más en el patrón subyacente que en la implementación real, ya que puede variar según tu elección de [API gateway](https://api7.ai/learning-center/api-gateway-guide/what-is-an-api-gateway).

Dividiré estos patrones en tres categorías:

1. Autenticación y seguridad
2. Monitoreo y observabilidad
3. Control de versiones y tiempo de inactividad cero

Veremos cada categoría en detalle a continuación.

### Autenticación y Seguridad

#### Autenticación de Usuario

Las solicitudes autenticadas con API gateways aseguran las interacciones cliente-API. Después de que un cliente se autentica, tu API gateway puede usar los detalles del cliente obtenidos para un control granular.

![network error/user authentication.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093420.png?imageMogr2/format/webp)

APISIX maneja la autenticación directamente a través de plugins como [key-auth](https://apisix.apache.org/docs/apisix/plugins/key-auth/) y [jwt-auth](https://apisix.apache.org/docs/apisix/plugins/jwt-auth/). APISIX también soporta autenticación OAuth y sistemas de control de acceso basados en roles como wolf a través de plugins como [openid-connect](https://apisix.apache.org/docs/apisix/plugins/openid-connect/) y [wolf-rbac](https://apisix.apache.org/docs/apisix/plugins/wolf-rbac/), respectivamente.

#### Limitación de Tasa

Los picos de tráfico intencionales (ataques DoS) y no intencionales (clientes haciendo demasiadas solicitudes) a tus APIs pueden derribarlas como un castillo de naipes. Configurar [limitación de tasa](https://api7.ai/blog/rate-limiting-in-api-management) mejorará la confiabilidad de tus sistemas para manejar tales escenarios.

Puedes configurar la limitación de tasa en tu API gateway, y si el número de solicitudes aumenta por encima de un umbral, el API gateway podría retrasar o rechazar las solicitudes excedentes.

![network error/rate limiting.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093445.png?imageMogr2/format/webp)

Con APISIX, puedes usar cualquiera de los tres plugins para configurar límites de tasa basados en el número de solicitudes, el número de solicitudes concurrentes por cliente y el conteo ([limit-req](https://apisix.apache.org/docs/apisix/next/plugins/limit-req/), [limit-conn](https://apisix.apache.org/docs/apisix/next/plugins/limit-conn/), [limit-count](https://apisix.apache.org/docs/apisix/next/plugins/limit-count/)).

### Monitoreo y Observabilidad

La confiabilidad de tu API y tu configuración de monitoreo van de la mano. Y puedes monitorear tus métricas de confiabilidad configurando el monitoreo en tu API gateway.

![network error/monitoring and observability.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093513.png?imageMogr2/format/webp)

[Los registros de API](https://api7.ai/blog/apache-apisix-google-cloud) y los rastreos proporcionan información detallada sobre una llamada API. Esta información te ayudará a saber cuándo tu API ha fallado o tiene un error lo antes posible. Los fallos silenciosos llevan a errores no corregidos que pueden causar problemas en el futuro.

Con alguna configuración, también podrás predecir y anticipar el tráfico para el futuro, ayudándote a escalar de manera confiable.

APISIX tiene plugins que se integran con plataformas/especificaciones de registro ([Apache SkyWalking](https://apisix.apache.org/docs/apisix/next/plugins/skywalking-logger/), [RocketMQ](https://apisix.apache.org/docs/apisix/next/plugins/rocketmq-logger/)), métricas ([Prometheus](https://apisix.apache.org/docs/apisix/next/plugins/prometheus/), [Datadog](https://apisix.apache.org/docs/apisix/next/plugins/datadog/)), y rastreo ([OpenTelemetry](https://apisix.apache.org/docs/apisix/next/plugins/opentelemetry/), [Zipkin](https://apisix.apache.org/docs/apisix/next/plugins/zipkin/)). Puedes leer más sobre [Observabilidad de API con Plugins de APISIX](https://apisix.apache.org/blog/2022/04/17/api-observability/).

### Control de Versiones y Tiempo de Inactividad Cero

#### Lanzamiento Canario

Al cambiar a nuevas versiones de tus APIs, debes asegurarte de no perder tu tráfico. Los clientes aún deberían poder hacer solicitudes a tu API y obtener la respuesta correcta.

Con un [API gateway](https://api7.ai/blog/api-gateway-deployment-patterns), puedes configurar lanzamientos canarios. Esto asegurará que tu API permanezca funcional durante la transición, y también puedes volver a la versión anterior si hay algún problema.

Inicialmente, el API gateway enrutará todo el tráfico a la versión antigua de tu API.

![network error/old version.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093542.png?imageMogr2/format/webp)

Cuando tengas una nueva versión, puedes configurar el API gateway para enrutar parte de tu tráfico a esta nueva versión. Puedes seguir aumentando el porcentaje de tráfico a tu nuevo servicio y verificar si todo está funcionando como se espera.

![network error/canary release.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093559.png?imageMogr2/format/webp)

Finalmente, puedes enrutar todo el tráfico a tu nueva API.

![network error/new API](https://static.api7.ai/2022/blog/0819/2022-08-19-100732.png?imageMogr2/format/webp)

APISIX usa el plugin [traffic-split](https://apisix.apache.org/docs/apisix/next/plugins/traffic-split/) que te permite controlar el tráfico a tus servicios. Puedes usarlo para configurar lanzamientos canarios o tu configuración de lanzamiento personalizada.

#### Circuit Breaking

Cuando uno de tus servicios upstream no está disponible o está experimentando alta latencia, necesita ser desconectado de tu sistema. De lo contrario, el cliente seguirá reintentando la solicitud, lo que llevará al agotamiento de recursos. Este fallo puede extenderse a otros servicios en tu sistema y derribarlos.

Al igual que los interruptores eléctricos aíslan componentes defectuosos de un circuito, los API gateways tienen una función de circuit breaker que desconecta servicios defectuosos, manteniendo el sistema saludable. El tráfico a estos servicios se redirige o retrasa hasta que el servicio se vuelve saludable.

![network error/circuit breaking.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093714.png?imageMogr2/format/webp)

APISIX viene con un plugin [api-breaker](https://apisix.apache.org/docs/apisix/next/plugins/api-breaker/) que implementa este patrón.

#### Redirecciones

A medida que actualizas tus APIs, sus endpoints pueden sufrir algunos cambios. Tradicionalmente, esto significaría que la aplicación cliente debería enviar solicitudes al `/new-api-endpoint` en lugar del `/old-api-endpoint`, lo que significa que tus consumidores deben cambiar manualmente cada llamada a este endpoint API.

Si no se anticipa, esto puede romper las aplicaciones cliente.

Con un API gateway, puedes proporcionar una capa de abstracción y redirigir las solicitudes al `/new-api-endpoint` sin que los clientes tengan que cambiar sus solicitudes. Con códigos de estado y mensajes de redirección adecuados, puedes depreciar gradualmente el `/old-api-endpoint` sin que tus consumidores experimenten ningún tiempo de inactividad.

![network error/redirect.png](https://static.api7.ai/2022/blog/0819/2022-08-19-093729.png?imageMogr2/format/webp)

Con APISIX, puedes usar el plugin [redirect](https://apisix.apache.org/docs/apisix/next/plugins/redirect/) para configurar redirecciones.

## Conclusión

Cuando la confiabilidad se convierte en una preocupación principal, es evidente que los API gateways son necesarios a medida que más organizaciones dividen sus monolitos en [microservicios](https://api7.ai/blog/what-are-microservices) y se mueven a arquitecturas nativas de la nube.

Sin embargo, esto no significa que los API gateways sean para todos. Dependiendo del tamaño y uso de tu API, un API gateway podría ser excesivo, y podrías arreglártelas usando un proxy inverso con capacidades básicas de enrutamiento y balanceo de carga.

Los casos de uso mencionados aquí solo arañan la superficie de las capacidades de un API gateway. Puedes aprender más sobre API gateways y Apache APISIX en [apisix.apache.org](https://apisix.apache.org/).

Tags:

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

Share article link

Share

Related Posts

[![Una comparación exhaustiva de API Gateways, Kubernetes Gateways y Service Meshes](https://static.api7.ai/uploads/2023/06/07/KS3wtoLx_cover.png)](https://api7.ai/blog/gateway-and-mesh)

## [Una comparación exhaustiva de API Gateways, Kubernetes Gateways y Service Meshes](https://api7.ai/blog/gateway-and-mesh)

[![Las 10 principales tendencias de API Management para 2023](https://static.api7.ai/uploads/2023/04/12/PtHsoEJS_top-10-trends.png)](https://api7.ai/blog/10-api-management-trends-2023)

## [Las 10 principales tendencias de API Management para 2023](https://api7.ai/blog/10-api-management-trends-2023)

Table of Contents

- [¿Qué hace que una API sea confiable?](#qu%C3%A9-hace-que-una-api-sea-confiable)

- [API Gateway, el punto de entrada unificado](#api-gateway-el-punto-de-entrada-unificado)

- [Mejores prácticas de confiabilidad con API gateways](#mejores-pr%C3%A1cticas-de-confiabilidad-con-api-gateways)

  - [Autenticación y Seguridad](#autenticaci%C3%B3n-y-seguridad)
  - [Monitoreo y Observabilidad](#monitoreo-y-observabilidad)
  - [Control de Versiones y Tiempo de Inactividad Cero](#control-de-versiones-y-tiempo-de-inactividad-cero)

- [Conclusión](#conclusi%C3%B3n)

## Related Posts

[![API Gateway vs. Gestión de API](https://static.api7.ai/uploads/2024/12/25/zQTHfZGV_api-gateway-vs-api-management.jpg)](https://api7.ai/es/blog/api-gateway-and-api-management-comparison)

Technology

September 1, 2023

#### [API Gateway vs. Gestión de API](https://api7.ai/es/blog/api-gateway-and-api-management-comparison)

Descubre qué son el API gateway y la gestión de API, y explora sus relaciones y diferencias.

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[API Management](https://api7.ai/tags/api-management)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[![Sesiones Persistentes con Apache APISIX - Teoría](https://static.api7.ai/uploads/2023/07/28/d33oDxuF_Sticky-Sessions.png)](https://api7.ai/es/blog/sticky-sessions-theory)

Technology

July 27, 2023

#### [Sesiones Persistentes con Apache APISIX - Teoría](https://api7.ai/es/blog/sticky-sessions-theory)

Let's learn the reasons behind sticky sessions, available alternatives, and how to implement them via Apache APISIX.

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[Sticky Sessions](https://api7.ai/tags/sticky-sessions)

[![Desarrollo de Plugins Personalizados para APISIX con Lua y ChatGPT](https://static.api7.ai/uploads/2024/12/25/MssMP69w_custom-plugin-development.png)](https://api7.ai/es/blog/plugin-development-with-lua-and-chatgpt)

Technology

June 12, 2023

#### [Desarrollo de Plugins Personalizados para APISIX con Lua y ChatGPT](https://api7.ai/es/blog/plugin-development-with-lua-and-chatgpt)

Este artículo te guiará a través del proceso de desarrollo de un nuevo plugin personalizado llamado file-proxy para APISIX utilizando Lua y ChatGPT.

[API Gateway Concept](https://api7.ai/tags/api-gateway-concept)

[APISIX Basics](https://api7.ai/tags/apisix-basics)

[Plugin](https://api7.ai/tags/plugin)
