Crear un backend
Un backend es una simulación desplegada que sirve los proveedores que elijas. Esta página lo lleva de la nada a una URL que tu integración puede llamar.
Antes de empezar
Necesitas un proveedor. Un backend tiene que servir algo, y solo puede servir marcas que tu organización ya tenga.
Consulta Agregar proveedores.
Tu plan tiene que permitir un backend, y la app lo dice en la página Backends cuando no lo permite. Un backend es una simulación como cualquier otra, así que también sale del mismo cupo de simulaciones que el resto de tu trabajo.
Quien tenga el rol de editor o superior puede crear uno. Comprar proveedores es solo para owners, pero armar un backend con lo que la organización ya tiene no lo es.
Créalo
Abre Backends y usa Nuevo backend en la fila del tipo que quieras. También puedes empezar desde Simulaciones, donde los backends viven junto a todo lo demás.
Tres campos:
- Tipo es pagos o identidad. No se puede cambiar después, porque decide qué motor corre.
- Nombre es para ti, y es lo que lista la app. Cámbialo cuando quieras.
- Segmento de URL es parte de la dirección. En minúsculas, máximo 15 caracteres.
El segmento se puede editar hasta el primer despliegue y queda fijo después. Es a propósito: está en el medio de la URL que llama tu código y prefija todo lo que el backend registra, así que renombrarlo después rompería las integraciones en marcha y dejaría los registros huérfanos al mismo tiempo.
Crear un backend todavía no sirve nada. No tiene proveedores hasta que los elijas, y un backend sin ninguno se rechaza al desplegar.
Elige qué sirve
Abre el backend y ve a Proveedores. Aparece todo lo que tiene la organización, y marcas lo que sirve este.
Elige al nivel que te sirva:
- La marca, como Adyen, que cubre todas las APIs y versiones de abajo.
- Una API de esa marca.
- Una versión exacta, como
adyen/checkout/v71.
Marcar la marca cubre todo lo que hay debajo, y las filas más finas lo dicen en vez de dejarte marcar dos veces lo mismo. Seleccionar todo toma cada marca que tengas.
Acá solo aparecen las marcas que tiene tu organización. Si el build que corre el backend ya no trae alguna, queda marcada y no se puede elegir.
Correr más de un backend con elecciones distintas es normal. Si un backend sirve una sola marca, cada solicitud llega a ese proveedor y a ningún otro, que es lo que quieres cuando un test es sobre una integración.
Despliégalo
Desplegar pone el backend en marcha. No sirve nada hasta que lo hagas, y los cambios de proveedores llegan a un backend corriendo del mismo modo: guarda y después despliega.
La píldora de estado avanza hasta Activa y la URL empieza a responder. El primer despliegue tarda más que los siguientes, porque se está ubicando el runtime.
La dirección sigue el patrón que usa cada simulación, con cada proveedor bajo su propio prefijo:
https://<dominio>/pay/<tu-org>/<nombre>/adyen/checkout/v71/payments
https://<dominio>/kyx/<tu-org>/<nombre>/onfido/v3.6/applicantsTodo lo que va después del prefijo es la ruta propia del proveedor, así que apuntar tu integración al backend es cambiar la URL base y nada más.
Ajustes que vale conocer
General guarda el nombre, el segmento de URL y Comportamiento, que controla qué hace el backend además de responder:
- Explorador de API muestra una interfaz navegable en la URL del backend. Apágalo y solo responde la API.
- Registrar tráfico guarda cada solicitud y cada respuesta, que es lo que llena el Historial. Guardar por es cuánto viven.
- Replay graba una respuesta una vez y después responde con ella a las solicitudes que coincidan.
Despliegue es dónde corre, y Acceso es quién puede llegar. Los dos se comportan como en cualquier simulación.
Consulta Control de acceso.
Una vez que está en marcha
El backend guarda un registro de lo que ha hecho, que se puede recorrer por proveedor.
Consulta Actividad del backend.
Por defecto sigue el último build publicado. Fíjalo a un build si una suite de tests necesita las mismas respuestas a lo largo del tiempo.
Consulta Fijar una versión de build.