Los maps son ficheros JSON dentro de la carpeta Maps del API. Pueden ir en la raíz o en una carpeta con un nombre de un entorno que uses. Si el map, va dentro de una carpeta cuyo nombre es un entorno, leerás ese Map sólo si la API está desplegada en ese entorno.

Los maps se usan para dos cosas:

• Un map puede ser un json-schema, y ser utilizado para hacer validaciones.
• Un map puede contener atributos como Urls, apiKeys, constantes, etc; de forma que puedas mantener separados esos valores del código, usarlos como argumentos de directivas, o conseguir que tengan distintos valores dependiendo del entorno en el que esté desplegada la API.

Para que tu API se conecte a dos microservicios distintos dependiendo del entorno podrías tener estos maps:

	Maps/dev/urls.json
	{
		"target" : "https://dev-url.org"
	}

	Maps/pro/urls.json
	{
		"target" : "https://microservice.org"
	}

Luego podrías usar un alias para leer el map:

key: poems
endpoints:
	all /requests:
	    Http:
            directive: Http
            host: $.map.main.target

De forma que en el entorno dev el host sería: https://dev-url.org y en pro el host sería https://microservice.org

También lo podrías leer desde una directiva utilizando el estado, con los siguientes métodos:

	$state->map('main')->get('target');//Devolvería https://dev-url.org o https://microservice.org dependiendo del entorno
	$state->map('main')->read();//Devolvería un array con el JSON completo

Ir a la home