Incorporacion documentacion para las distintas versiones

Author: UrbinaBenavides

docs/getting-started/setup.rst

@@ -1,49 +1,106 @@
 Configuración
 =============
 
-Para utilizar el cliente de API de API Gateway, se debe tener un token de usuario, generado y obtenido desde la cuenta de API Gateway.
+Para utilizar el cliente de API de API Gateway, se debe tener un token de usuario generado desde la cuenta de API Gateway.
 
 .. important::
-    El archivo test.env sólo sirve para usar con los test. Por lo que se deberán definir las variables de entorno por los siguientes dos métodos: Directo por consola (temporal), o definirlas directamente en el entorno (persistente).
+   El archivo ``test.env`` sólo sirve para usar con los test.
 
-En Linux o MacOS:
------------------
+Versiones de API
+----------------
 
-El token se almacena en una variable de entorno. Para almacenar en una variable de entorno, se debe escribir lo siguiente en consola:
+El cliente permite utilizar dos versiones de la API mediante variables de entorno.
+
+**API v1 (legacy)**
+
+- URL: ``https://legacy.apigateway.cl``
+
+**API v2 (recomendada)**
+
+- URL: ``https://app.apigateway.cl``
+
+.. note::
+   Si no se define ``APIGATEWAY_API_VERSION`` el cliente utilizará automáticamente **v2**.
+
+Variables de entorno
+--------------------
+
+Las siguientes variables deben definirse en el sistema:
+
+- ``APIGATEWAY_API_URL``
+- ``APIGATEWAY_API_VERSION``
+- ``APIGATEWAY_API_TOKEN``
+
+``APIGATEWAY_API_TOKEN`` es una cadena extremadamente larga. Guárdala en un lugar seguro.
+
+Linux o MacOS
+-------------
+
+**Configuración para API v1**
 
 .. code-block:: shell
+
     export APIGATEWAY_API_URL="https://legacy.apigateway.cl"
+    export APIGATEWAY_API_VERSION="v1"
     export APIGATEWAY_API_TOKEN="aqui-su-token-de-apigateway"
 
-- ``APIGATEWAY_API_TOKEN`` es una cadena de caracteres extremadamente larga. Almacena ese token en un lugar seguro y no lo compartas con nadie.
+**Configuración para API v2**
+
+.. code-block:: shell
+
+    export APIGATEWAY_API_URL="https://app.apigateway.cl"
+    export APIGATEWAY_API_VERSION="v2"
+    export APIGATEWAY_API_TOKEN="aqui-su-token-de-apigateway"
 
-Introducir en consola las variables de entorno almacena temporalmente las variables, y alternativamente, se puede modificar el archivo de configuración de shell en Linux (que se explicará a continuación), y añadir al final del archivo los comandos previamente introducidos. Añadir variables de entorno de esta forma es más persistente y no se repite su definición.
+Para hacerlo persistente:
 
-- Si se usa Linux, se deben añadir al archivo ``~/.bashrc`` los comandos previamente definidos.
-- Si se usa MacOS, se deben añadir al archivo ``~/.zshrc``.
+- Linux: añadir al archivo ``~/.bashrc``
+- MacOS: añadir al archivo ``~/.zshrc``
 
-El paso siguiente sólo se hace para usuarios de MacOS. Por último, ejecutar el comando en cuestión para efectuar los cambios.
+Luego ejecutar:
 
 .. code-block:: shell
+
     source ~/.zshrc
 
-En Windows:
------------
+Windows
+-------
 
-Para almacenar en una variable de entorno en Windows, hay varias alternativas. La primera es utilizando cmd, y para almacenarlas utilizando cmd, ejecuta en el buscador de Windows "cmd", y ejecuta los siguientes comandos:
+**CMD – API v1**
 
 .. code-block:: shell
+
     setx APIGATEWAY_API_URL "https://legacy.apigateway.cl"
+    setx APIGATEWAY_API_VERSION "v1"
+    setx APIGATEWAY_API_TOKEN "aqui-su-token-de-apigateway"
+
+**CMD – API v2**
+
+.. code-block:: shell
+
+    setx APIGATEWAY_API_URL "https://app.apigateway.cl"
+    setx APIGATEWAY_API_VERSION "v2"
     setx APIGATEWAY_API_TOKEN "aqui-su-token-de-apigateway"
 
-También se pueden definir utilizando Windows PowerShell, de una manera similar. Ejecuta en el buscador de Windows "PowerShell", y ejecuta los siguientes comandos:
+**PowerShell – API v1**
 
 .. code-block:: shell
+
     $Env:APIGATEWAY_API_URL = "https://legacy.apigateway.cl"
+    $Env:APIGATEWAY_API_VERSION = "v1"
     $Env:APIGATEWAY_API_TOKEN = "aqui-su-token-de-apigateway"
 
-Como alternativa para almacenar las variables de manera persistente, debes seguir los siguientes pasos:
+**PowerShell – API v2**
+
+.. code-block:: shell
+
+    $Env:APIGATEWAY_API_URL = "https://app.apigateway.cl"
+    $Env:APIGATEWAY_API_VERSION = "v2"
+    $Env:APIGATEWAY_API_TOKEN = "aqui-su-token-de-apigateway"
+
+.. important::
+    Como alternativa para almacenar las variables de manera persistente, debes seguir los siguientes pasos:
 
-1.  Abre el Panel de Control > Sistema > Configuración avanzada del sistema.
-2.  En la pestaña Opciones avanzadas, selecciona Variables de entorno.
-3.  Añade o modifica las variables en la sección de "Variables de usuario" o "Variables del sistema".
+    1.  Abre el Panel de Control > Sistema > Configuración avanzada del sistema.
+    2.  En la pestaña Opciones avanzadas, selecciona Variables de entorno.
+    3.  Añade o modifica las variables en la sección de "Variables de usuario" o "Variables del sistema".