Variables de Jitterbit API¶
Introducción¶
Esta página cubre las variables de Jitterbit que están disponibles para las APIs personalizadas de Jitterbit, organizadas por variables informativas que lee (Informativo) y las variables de configuración que usted escribe (Configuración).
Las variables que terminan en un asterisco (*) indican que el asterisco debe reemplazarse con un nombre de encabezado, como en jitterbit.target.http.response.header.X-Jitterbit-Authorization.
Nota
Para variables Jitterbit con un guión en su nombre, use el Get
y Set
funciones para recuperar y establecer sus valores. Por ejemplo: Get('jitterbit.target.http.response.header.X-Jitterbit-Authorization')
.
Informativo¶
jitterbit.api.request.body
yjitterbit.api.request.body.*
¶
Tipo de Datos¶
Cadena
Descripción¶
Mira la carga / cargas útiles enviadas a la API. Tenga en cuenta que para la mayoría de las APIs, esperaría solo una carga útil simple y, como tal, jitterbit.api.request.body
es la variable a utilizar (también conocida como content-type:text/plain
).
Si espera que se envíen varias cargas útiles a la vez, utilice el formulario codificado en URL (también conocido como content-type:application/x-www-form-urlencoded
), como en el caso de que se utilice una API como backend de un formulario de envío (consulte http://www.w3.org/TR/html401/interact/forms.html ), entonces debería utilizar jitterbit.api.request.body.*
. Al igual que con jitterbit.api.request.parameters.*
, jitterbit.api.request.body.name
será igual a EStore
si el valor del campo "nombre" del formulario se ingresó como EStore
.
jitterbit.api.request.enum.body
¶
Tipo de Datos¶
Cadena
Descripción¶
Matriz de variables utilizada para iterar dinámicamente a través de todas las partes enviadas de la carga útil / cuerpo (en lugar de verificar una parte específica como con jitterbit.api.request.body.*
). El uso es el mismo que con el jitterbit.api.request.enum.parameters
.
jitterbit.api.request.enum.headers
¶
Tipo de Datos¶
Cadena
Descripción¶
Matriz de variables utilizada para iterar dinámicamente a través de todos los encabezados de solicitud (en lugar de verificar encabezados específicos como con jitterbit.api.request.headers.*
). El uso es el mismo que con el jitterbit.api.request.enum.parameters
y jitterbit.api.request.enum.body
.
jitterbit.api.request.enum.mvparameters
¶
Tipo de Datos¶
Cadena
Descripción¶
Matriz de variables utilizada para iterar dinámicamente a través de todos los parámetros de valores múltiples (en lugar de verificar cada parámetro específicamente como jitterbit.api.request.mvparameters.ProdID
).
jitterbit.api.request.enum.parameters
¶
Tipo de Datos¶
Cadena
Descripción¶
Matriz de variables utilizada para iterar dinámicamente a través de todos los parámetros enviados (en lugar de verificar cada parámetro específicamente como jitterbit.api.request.parameters.name
).
Este secuencia de comandos de muestra agrega todos los parámetros proporcionados a una nueva variable para mostrarla más tarde al usuario:
<trans>
$output = "URL Parameters: <br>\r\n";
enum = $jitterbit.api.request.enum.parameters;
i = 0;
while(i<length(enum),
name = enum[i];
$output = $output + "$" + name + ": " + Get(name) + " <br>\r\n";
i = i+1;
);
if(i==0, $output = $output + "(none)<br>\r\n");
</trans>
jitterbit.api.request.headers.*
¶
Tipo de Datos¶
Cadena
Descripción¶
Variable utilizada para ver los encabezados de solicitud enviados a la API; Por ejemplo, $jitterbit.api.request.headers.x_forwarded_for
es la IP pública del buzón/usuario que accede a la URL.
jitterbit.api.request.headers.fulluri
¶
Tipo de Datos¶
Cadena
Descripción¶
La URL a la que se llamó para activar Jitterbit OData o API Personalizada.
jitterbit.api.request.method
¶
Tipo de Datos¶
Cadena
Descripción¶
El método de solicitud que se utilizó para llamar a la API.
jitterbit.api.request.mvparameters.*
¶
Tipo de Datos¶
Cadena
Descripción¶
Mira los valores múltiples del parámetro enviado a la API directamente a través de la URL y devuelve los valores como una matriz con un espacio entre cada valor.
Por ejemplo, si la URL es https://jitterbitxx.na.jitterbit.org/dev/ProductAPIResponse?ProdID=abc&ProdID=abc1&ProdID=abc2
, entonces jitterbit.api.request.mvparameters.ProdID
será abc abc1 abc2
.
jitterbit.api.request.parameters.*
¶
Tipo de Datos¶
Cadena
Descripción¶
Mira los parámetros enviados a la API directamente a través de la URL; Por ejemplo, jitterbit.api.request.parameters.name
será igual a EStore
si la URL solicitada tuviera &name=EStore
.
Nota
Los parámetros de URL de valores múltiples devolverán una cadena delimitada por |||
(3 tubos). Para devolver parámetros de URL de valores múltiples como una matriz, use el jitterbit.api.request.mvparameters.*
variable en su lugar.
Por ejemplo, si la URL es https://jitterbitxx.na.jitterbit.org/dev/ProductAPIResponse?ProdID=abc&ProdID=abc1&ProdID=abc2
, entonces jitterbit.api.request.parameters.ProdID
será abc|||abc1|||abc2
.
Ajustes¶
jitterbit.api.response
¶
Tipo de Datos¶
Cadena
Descripción¶
Esta variable debe configurarse si su API Personalizada está configurado para utilizar una Variable de sistema como tipo de respuesta. El jitterbit.api.response
la variable se puede utilizar varias veces a lo largo de una cadena de operación, pero se debe configurar para cada uso.
Consejo
El jitterbit.api.response
la variable se puede configurar y utilizar en una Variable extremo al que se hará referencia en las mismas operaciones o en abajo en la cadena.
jitterbit.api.response.blank_error_response
¶
Tipo de Datos¶
Booleano
Descripción¶
Permite que se devuelva una respuesta API en blanco para no200
-escribir códigos de estado cuando jitterbit.api.response.blank_error_response
se establece en true
. Cuando se establece en false
(predeterminado), se representa una página de estado HTML para el código de estado devuelto. Disponible para usar con el agente y Pasarela de API versiones 10.59 o posteriores.
jitterbit.api.response.headers.*
¶
Tipo de Datos¶
Cadena
Descripción¶
Se utiliza para configurar los encabezados de respuesta de la API. Por ejemplo, establezca jitterbit.api.response.headers.access_control_allow_origin="*"
para anular el comportamiento predeterminado de CORS y permitir que cualquier dominio acceda a la API entre sitios.
jitterbit.api.response.status_code
¶
Tipo de Datos¶
Cadena
Descripción¶
Proporciona la capacidad de anular el código de respuesta HTTP para APIs personalizadas mediante la variable de secuencia de comandos Jitterbit. Selecciona el jitterbit.api.response.status_code
variable en el secuencia de comandos que ejecuta una API Personalizada. Esto permite a los autores de proyectos establecer un código de error HTTP específico (junto con información de carga útil real) en lugar de confiar en que el sistema devuelva los códigos 200 o 500 según el comportamiento predeterminado.