Crítica técnica a las APIs: documentación bloqueada y credenciales complejas

Fuentes: Technical critique of APIs: gated docs and complex credentials

Un desarrollador detalla sus frustraciones con la experiencia de integración de APIs actuales, destacando problemas de documentación, seguridad y diseño. El autor critica la necesidad de autenticación para acceder a la documentación técnica, lo que interrumpe el flujo de trabajo y dificulta la integración con agentes de IA. Además, señala la falta de cumplimiento de la especificación OpenAPI, que ha existido durante 15 años, y la dependencia de formatos inferiores como las colecciones de Postman. En cuanto a la gestión de credenciales, el texto denuncia la complejidad de la emisión de claves, que suele requerir intervención manual de equipos de TI y crea conflictos de seguridad al vincular las credenciales a la identidad del creador, impidiendo la rotación segura. El autor también critica el diseño de webhooks de ciertos proveedores, que exigen la verificación del endpoint antes de permitir la validación de payloads con secretos compartidos, un requisito que contradice las mejores prácticas de seguridad. Finalmente, el texto lamenta que empresas de pagos, con más de 15 años de experiencia, no adopten modelos de API probados como el de Stripe, priorizando la innovación sobre la usabilidad. A pesar de estas quejas, el autor reconoce que la automatización ha reducido significativamente el tiempo de onboarding, aunque la experiencia de desarrollador sigue siendo un punto de mejora crítico para la industria.