En redes móviles, satelitales, rurales, Wi-Fi saturado o vehículos en movimiento, la llamada puede llegar al servidor y perderse la respuesta. El ancho de banda cambia durante el upload y la reconexión usa otra ruta. El contrato debe volver segura esa incertidumbre.
Mida DNS, conexión, TLS, upload, procesamiento, first byte, descarga, pérdida, reconexión y cambios de radio. Segmente por país, operador/ASN, red, app, dispositivo, endpoint, payload e intento. p50 oculta a quien cruza repetidamente el timeout.
La operación necesita un presupuesto, no 30 segundos por salto. Reserve DNS/connect/TLS, primer intento, retry opcional, parsing y UI. Propague el saldo downstream y cancele trabajo abandonado. Separe timeout de conexión y request/idle.
Repita GET/HEAD ante fallas transitorias. PUT/DELETE pueden ser idempotentes por contrato, pero una implementación puede disparar efectos externos. No repita POST/PATCH sin idempotency contract. Validación, autenticación, autorización, conflicto y not-found permanente no son pérdida de paquetes.
SDK 3x, gateway 3x y servicio 3x producen 27 llamadas. Elija la capa que conoce semántica y presupuesto. Use retry quota/token bucket, límites, full jitter, Retry-After y desactive ante falla sostenida.
| Resultado | Interpretación | Política | Contrato servidor | Evitar |
|---|---|---|---|---|
| Conexión perdida sin respuesta | Outcome del write desconocido. | Retry solo seguro/idempotente o keyed. | Estado consultable por key/ID. | Crear compra duplicada. |
| 408 / timeout | No completó en contexto. | Retry acotado si queda budget. | Detener trabajo y deduplicar. | Reiniciar operación larga. |
| 429 / cuota | El caller excedió política. | Respetar tiempo y regular tráfico. | Política legible por máquina. | Todos repiten juntos. |
| 502/503/504 | Upstream, overload o gateway transitorio. | Retry pequeño con jitter; fallback de lectura. | Load shedding y Retry-After. | Retry storm. |
| 409 conflicto | Estado actual rechaza cambio. | Leer y conciliar. | Problem details y revisión. | Sobrescribir concurrencia. |
| 4xx validación/auth | Request o autoridad debe cambiar. | Sin retry de transporte. | Tipo, campos, remedio y request ID. | Gastar batería repitiendo. |
El cliente crea una key de alta entropía ligada a principal y ruta. El servidor guarda key, fingerprint, estado, operación/recurso, resultado, timestamps y expiración. Misma key/payload devuelve outcome original; payload distinto se rechaza. Duplicados concurrentes esperan o reciben “en progreso”. Persista el registro con el efecto de forma atómica.
Devuelva 202 Accepted con URL de operación. Exponga pending/running/succeeded/failed/cancelled, tiempos, resultado y problem detail. Polling usa backoff y ETag, o evento firmado. No mantenga una conexión móvil abierta durante minutos.
Cada lista nace paginada. El cursor liga query, filtros, sort, snapshot/boundary, dirección y última tupla, por ejemplo (updated_at, id). Tokens son opacos e íntegros. Offset sirve para conjuntos pequeños/estáticos; colecciones mutables producen duplicados y saltos.
Use page size acotado, field masks, summaries, filtros, delta sync, updated_since estable y medios separados. El cliente necesita la próxima pantalla accionable, no todo el dominio.
Use Accept-Encoding y Vary: Accept-Encoding. Comprima JSON, texto, protobuf y SVG sobre un umbral. No recomprima JPEG/AVIF/video. Compare Brotli, gzip y Zstandard por tamaño, CPU, batería y latencia.
Use Cache-Control, ETag, If-None-Match y Last-Modified. Separe público/personal, defina Vary y freshness. Datos stale requieren as_of y acciones limitadas. Cache-Status ayuda a depurar.
Upload por partes usa ID, offset/part, checksum, expiración, metadata y finalize. Downloads usan ranges y validators. Repita partes faltantes. tus es una opción establecida. No complete antes de verificar longitud y digest.
RFC 9457 define type, title, status, detail e instance. Agregue código estable, campos, retryability, correlation ID y remediación. No exponga stack ni obligue a parsear texto localizado.
HTTP/3 sobre QUIC mejora pérdida y cambios; prioridad HTTP comunica urgencia. Reuso, TLS resumption, edge y menos secuencias ayudan. Nada evita efectos duplicados, listas ilimitadas, errores ambiguos o writes stale.
Trace una operación por operation ID y request ID por intento. Registre timings, bytes, compresión, caché, red, fase del timeout, retry, idempotencia, cursor, stale mode, cola y outcome. Mida amplificación, deduplicación, conclusión por red, datos/batería y p95/p99.
SDK con deadline, timeouts, clasificación, full-jitter, quota, keys, polling, cursor, caché condicional, uploads reanudables, outbox, conflictos y telemetría. Servidor con storage idempotente, problem details, load shedding, paginación, field masks, operaciones, ETags, cancelación y trazas por intento.
Una API confiable no finge que la red es confiable. Vuelve recuperable cada outcome incierto, acota retries, deduplica writes, reanuda transferencias y hace visible el estado degradado.
Artículo sobre APIs confiables en redes variables, retries, backoff, jitter, idempotencia, compresión, paginación, caché, reanudación, colas offline y degradación.