La salida HTTP de ArcGIS Velocity permite enviar entidades y otros textos a un extremo HTTP a través de solicitudes POST, PUT o DELETE. Se envía una solicitud para cada entidad de salida enviada a la salida.
Ejemplo
Un analista configura una salida HTTP para enviar entidades en un formato JSON personalizado a un webhook designado.
Notas de uso
Tenga en cuenta lo siguiente al trabajar con la salida de HTTP:
- Al enviar JSON en el cuerpo de una solicitud, ajuste el JSON con la expresión de Text() Arcade para dar un formato adecuado al JSON.
- Al utilizar la salida HTTP, es importante entender la velocidad de los datos. Cada registro enviado a la salida genera una solicitud separada. Con ello se puede sobrecargar rápidamente la configuración de capacidad o límite de velocidad de un servidor web. Utilice la salida HTTP para los incidentes que se espera que se produzcan con poca frecuencia.
- Al utilizar la autenticación de OAuth:
- El tipo de salida HTTP admite la autenticación mediante OAuth 2.0 para extremos HTTP que siguen los tipos de concesión Credenciales de cliente o Contraseña. Estos tipos de concesión de OAuth siguen un patrón que incluye la configuración de una solicitud HTTP para obtener un token de acceso. Durante la configuración de la solicitud de token de acceso, se le pide que identifique el token de acceso y los campos JSON clave de caducidad de la respuesta del servidor de autorización de OAuth. Si se selecciona una caducidad, debe definir el tipo de caducidad (duración o marca de tiempo) y las unidades.
- Al volver a la configuración de la solicitud de datos, debe utilizar la variable global $accessToken para definir dónde se utilizará el token de acceso. Suele ser en un encabezado personalizado de Authorization con el valor Bearer $accessToken.
Parámetros
A continuación se indican los parámetros de la salida de HTTP:
| Parámetro | Descripción | Tipo de datos |
|---|---|---|
URL | La dirección URL mediante la que se envían las solicitudes de salida. | Cadena de caracteres |
Método HTTP | Método HTTP de la solicitud. Las opciones incluyen POST, PUT y DELETE | Cadena de caracteres |
Cuerpo POST | La expresión JSON Arcade. | Expresión de Arcade |
Tipo de contenido | El encabezado Tipo de contenido de las solicitudes salientes.
| Cadena de caracteres |
Tipo de autenticación | Elija entre la autenticación sin autenticación, Basic o OAuth. Si la autenticación básica está configurada, aparecerán campos adicionales para introducir nombre de usuario y contraseña. Cuando se configura la autenticación OAuth, aparece una ventana emergente de configuración:
Una vez especificado lo anterior, se probará la conexión y debe hacer clic para identificar el token de acceso en la respuesta JSON. | Varios parámetros |
Parámetros de la URL | Parámetros de URL opcionales que se incluyen en la URL de la solicitud HTTP enviada al sitio web especificado. Aunque los parámetros también se pueden establecer en el parámetro URL anterior, los parámetros de URL introducidos aquí como parámetros separados invalidan cualquier parámetro coincidente suministrado en el parámetro URL. Los parámetros de URL definidos en este parámetro siempre tendrán codificación URL. | Par de clave-valor |
Encabezados personalizados | Encabezados personalizados opcionales que se incluyen en la solicitud HTTP enviada al sitio web especificado. Por ejemplo, es posible utilizar encabezados personalizados para especificar una clave API de terceros o un encabezado de autorización. | Par de clave-valor |
Registro adicional | Opcionalmente active el registro de solicitudes y respuestas HTTP sin procesar emitidas por Velocity. Nota:Este parámetro solo debe activarse con fines de resolución de problemas y desactivarse cuando la resolución de problemas haya finalizado. Una vez activado, inicie el análisis y los registros del nivel de depuración estarán disponibles en la página de registros del análisis. En caso necesario, póngase en contacto con el Soporte técnico de Esri para que le ayude a solucionar los problemas. | Booleano |
Consideraciones y limitaciones
A continuación se indican las consideraciones y limitaciones de uso de la salida de HTTP:
- Al utilizar la autenticación de OAuth:
- Al crear una salida, se producen varias solicitudes a un servidor de autorización y al extremo de datos asociado. Algunas API implementan una limitación de velocidad para determinadas solicitudes, lo que podría afectar a la creación de la salida.
- Por motivos de seguridad, el cuerpo POST de la solicitud de token de acceso se debe reconfigurar al editar los parámetros de autenticación.
- El servidor web debe estar accesible externamente en Internet.