Cómo crear un endpoint de API

Los cinco pasos básicos para crear una API:
1.

Diseño

  • Defina la lógica de decisión que quiere resolver con Decisimo. Luego, prepare los datos que enviará al motor de decisiones. Como regla general, envíe todos los datos disponibles sobre la situación que quiere evaluar.
2.

Selección de la región de la instancia

  • Al elegir la región del endpoint de API, tenga en cuenta las normas de privacidad y protección de datos. La instancia es donde se establecerá el endpoint de API.
    Formulario API Endpoint con la región EUR - Belgium y el control Add para agregar flujos de decisiones
    Puede crear tantos endpoints como necesite en distintas regiones.
3.

Pruebas del endpoint

  • Puede crear varios endpoints, así que use endpoints separados para las pruebas y la producción. Antes de desplegar un flujo de decisiones en producción, pruébelo en el endpoint de pruebas con la herramienta que prefiera, como Postman o SoapUI.
4.

Integre estas comprobaciones en un flujo de decisión

Cree reglas de crédito, fraude o cobros y ejecútelas en decisiones en tiempo real.

Estructura de la solicitud y la respuesta

  • Los endpoints de API de Decisimo reciben datos JSON enviados mediante el método POST. La respuesta también está en JSON. Devuelve el mismo JSON, enriquecido o modificado por el flujo de decisiones.
5.

Despliegue del flujo de decisiones

  • Construya su primer flujo de decisiones y despliéguelo en su endpoint para empezar a automatizar la toma de decisiones.

Preguntas frecuentes

¿Qué cantidad de datos de entrada debo enviar a un endpoint de API de decisiones?

Envíe solo los campos que la lógica de decisión necesita para producir un resultado. Asigne cada dato de entrada a una regla o un cálculo y defina cómo debe gestionar el endpoint los valores faltantes o no válidos. No envíe por defecto todo el registro del cliente. Los campos innecesarios aumentan la exposición de datos y dificultan el mantenimiento de la estructura de entrada.

¿Debo usar endpoints de API separados para las pruebas y la producción?

Sí. Mantenga separado el endpoint de pruebas del endpoint de producción para que las solicitudes de prueba no afecten las decisiones en producción. Pruebe la release prevista con datos de entrada representativos, registre qué release probó y confirme que esa release esté desplegada en producción. Mantenga también separadas las credenciales y el tráfico de prueba.

¿Qué controles de seguridad debo completar antes de conectar una aplicación al endpoint?

Use los controles de autenticación y red que admite el endpoint, y guarde las credenciales en un gestor de secretos, no en el código de la aplicación. Confirme que la aplicación que realiza las llamadas envíe las solicitudes mediante una conexión cifrada y compruebe que se rechacen las solicitudes no autorizadas. Renueve las credenciales según la política de seguridad de su organización.

Integre estas comprobaciones en un flujo de decisión

Cree reglas de crédito, fraude o cobros y ejecútelas en decisiones en tiempo real.