Documentos de API

Solicitud de proxy

Solicitud de proxy - kintone.proxy()

Esta API realiza solicitudes a API externas. Los errores de CORS se pueden evitar mediante el uso de esta API. Para obtener más información sobre los errores de CORS, consulte el siguiente enlace de MDN Web Docs:
Errores de CORS (External link)

Función

kintone.proxy(url, method, headers, data, successCallback, failureCallback)

Parámetros

PARÁMETRO VALOR OBLIGATORIO DESCRIPCIÓN
url Cuerda Sí La dirección URL de la solicitud.
method Cuerda Sí El método HTTP. Especifique una de las siguientes opciones: OBTENER / PUBLICAR / PONER / ELIMINAR.
headers Objeto Sí Especifique el encabezado de la solicitud como un objeto. Para ignorar este parámetro, ingrese {}.
Muestra: { 'Content-Type': 'application/json' }
data Objeto o cadena Sí Los datos que se enviarán en la solicitud. Para ignorar este parámetro, ingrese {}.
Se aplica solo para solicitudes POST/PUT. Se omite para las solicitudes GET/DELETE.
En el caso de las solicitudes GET/DELETE, establezca el parámetro en QueryString de la dirección URL en su lugar.
successCallback Función Opcional La función de devolución de llamada que se ejecutará una vez que haya finalizado la solicitud al otro extremo del proxy. Recibirá el cuerpo de la respuesta (cadena), el código de estado (número) y el encabezado de la respuesta (objeto) como parámetros de la API externa.

Si se ignora, un kintone. Se devolverá un objeto de promesa que se puede cumplir con una matriz que contenga un cuerpo de respuesta (cadena), un código de estado (número) y un encabezado de respuesta (objeto).
failureCallback Función Opcional La función de devolución de llamada que se ejecutará cuando se produzca un error en la solicitud de API al otro extremo del proxy. Recibirá el cuerpo de la respuesta (cadena) como parámetro de la API externa.
Si se ignora la devolución de llamada, un kintone. Se devolverá un objeto de promesa que se puede cumplir con el cuerpo de respuesta (cadena) de la API de proxy.

Respuesta

Un kintone.Promise object se devolverá si el objeto successCallback o failureCallback se ignoran los parámetros. De lo contrario, no habrá respuesta.

Solicitud de muestra 

1
2
3
4
5

kintone.proxy('https://*****.***.net', 'GET', {}, {}, function(body, status, headers) {
  console.log(status, JSON.parse(body), headers);
}, function(error) {
  console.log(error); // Display the response body (string) from the proxy API
});

Solicitud de ejemplo mediante promesas 

1
2
3
4
5
6
7
8
9

kintone.proxy('https://*****.***.net', 'GET', {}, {}).then(function(args) {
  /*  args[0] -> body(string)
   *  args[1] -> status(number)
   *  args[2] -> headers(object)
   */
  console.log(args[1], JSON.parse(args[0]), args[2]);
}, function(error) {
  console.log(error); // Display the response body (string) from the proxy API
});

Notas

  • Se puede utilizar cualquier Content-Type.
  • Especificación de un valor inexistente url devolverá un código de estado de error de 503 (DNS Cache Missing).
  • Si las restricciones de dirección IP están habilitadas en el subdominio de origen, se debe permitir el acceso a la dirección IP kintone.com, si se utiliza kintone.proxy() en una aplicación dentro de un subdominio diferente. Puede encontrar una lista de direcciones IP utilizadas por Kintone en el siguiente artículo del sitio de ayuda:
    Dominios y direcciones IP utilizados por Kintone (External link)
    Tenga en cuenta que esto permitirá que cualquier dominio de Kintone eluda las restricciones de direcciones IP y, por lo tanto, no se recomienda desde el punto de vista de la seguridad.
  • Cuando utilice la API de REST de Kintone en su propio dominio de Kintone, utilice la solicitud de API de REST de Kintone en lugar de la kintone.proxy() API. Para obtener más información sobre la solicitud de API REST de Kintone, consulte el siguiente artículo:
    Solicitud de API REST de Kintone

Limitaciones

  • Esta API se puede utilizar tanto en computadoras de escritorio como en teléfonos inteligentes.
  • Esta API no se puede iniciar desde aplicaciones adjuntas a cuerpos de espacios/subprocesos/anuncios.
  • El sitio en el otro extremo del proxy no emitirá cookies automáticamente.
  • El tamaño máximo del encabezado de respuesta desde el otro extremo del proxy es de 100 líneas y el tamaño máximo de cada línea es de 8192 bytes.
  • Esta API solo puede manejar un cuerpo de caracteres de respuesta. No se admiten imágenes u otros datos binarios.
  • El tamaño máximo del cuerpo de la respuesta desde el otro extremo del proxy es de 10 MB.
  • No se admiten servidores que utilicen certificados SSL autofirmados.
  • El Content-Length encabezado y Transfer-Encoding los encabezados se agregan automáticamente si el método HTTP se establece en POST o PUT.
  • Configuración explícita headers provocará un error.