Preguntas frecuentes
El Modelo de Reúso es el paso a paso que debes seguir para consumir una API; este modelo te explica en qué ambientes debes consumir y cómo impactar de manera adecuada a los dueños de esas capacidades.
Al igual que en Sandbox debes crear una APP en el portal de APIs, solo que en el ambiente QA; en el artículo ¿Cómo suscribo un producto en mi aplicación? te mostramos el paso a paso.
Ahora, ten en cuenta que la aprobación a esta suscripción la realiza el equipo productor, y él lo hará solo si ya diligenciaste el formulario de reúso, tal y como está definido en el modelo de reúso.
Puedes visitar el artículo donde te explicamos cuál es el paso a paso para realizar la solicitud y las herramientas habilitadas para esto.
Para evitar problemas con tus solicitudes y evitar devoluciones o rechazos, asegúrate de:
- Tener en cuenta en qué etapas del proyecto necesitas ayuda para pruebas y reutilización en la fase de producción.
- Solicitar el reúso con al menos 2 sprints de antelación, ya que la aprobación depende de la capacidad del equipo que provee el servicio.
- Tener muy claras tus necesidades técnicas y de calidad para que, con ayuda del equipo productor, puedas contrastarlas con lo que te ofrece el producto de API.
- Contar con el blueprint, draft de arquitectura y el código único de tu aplicación (encuentra aquí cómo solicitarlo), antes de crear diligenciar el formulario de reúso.
- Si surgen problemas, asegúrate de comunicárselos al equipo proveedor a tiempo para que puedan ajustar sus recursos y ayudar a otros usuarios. Mantener una comunicación fluida es clave para un trabajo exitoso en equipo.
Te invitamos a explorar ¿Qué debes hacer para consumir y reusar una API?
Nuestro canal oficial de comunicación es el Centro de Ayuda, donde podrás acceder a documentación de soporte que te ayudará con la autogestión rápida y sencilla de tus dudas y consultas. Además, ahí mismo puedes usar el chat en vivo o el formulario de contáctanos para conversar con nuestro equipo de soporte de APIs.
Durante el proceso de pruebas te sugerimos revisar el contrato de la API así como los escenarios de pruebas, para comprender en su totalidad las capacidades que te brinda. Esta información la encuentras en el API Portal y en el portal de documentación como código.
Las aplicaciones te permiten obtener las credenciales necesarias para realizar consumos de productos API, también te permiten realizar y gestionar las suscripciones a los productos, ya que es necesario solicitar la suscripción antes de poder consumir un producto. Además en caso que requieras adjuntar un certificado digital.
Conoce el analista SOA de cada equipo productor y/o EVC en el siguiente enlace: Analistas SOA asignados a cada EVC.
Si ninguna de nuestras APIs satisface tu necesidad, ponte en contacto con el equipo productor y cuéntale sobre tu solicitud. En el siguiente sitio puedes encontrar cómo se registra esta dependencia: ¿Tienes una nueva necesidad?
En nuestro Portal de APIs, encontrarás toda la información que necesitas sobre los productos y sus APIs. Esto incluye el nombre del producto, el nombre de la API o API(s) correspondiente con sus versiones, además de datos sobre su uso en el negocio y detalles técnicos.
Puedes probar una API descargando su especificación en formato Swagger y utilizando herramientas como Insomnia. La especificación es esencial, ya que proporciona información detallada sobre la API.
Insomnia te permite enviar solicitudes, gestionar parámetros y visualizar respuestas de manera eficiente. Esta combinación de documentación técnica y herramientas de prueba simplifica el proceso de desarrollo y garantiza una integración efectiva con la API.
El siguiente articulo te muestra de forma práctica ¿Cómo probar las APIs en Insomnia?.