Documentos de API

Carga de archivos proxy

Carga de archivos proxy - kintone.proxy.upload()

Cargue un archivo fuera de Kintone.

Función

kintone.proxy.upload(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: POST / PUT.
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 Sí Los datos que se enviarán en la solicitud.
{ 'format': // format to be uploaded to the external service, 'value': // data to be uploaded}
Para formato, solo puede especificar la cadena "RAW".
Para valor, especifique el valor del tipo de blob (incluido el tipo de archivo). El tamaño máximo es de 200 MB.
successCallback Función Opcional La función de devolución de llamada que se ejecutará cuando finalice la solicitud al servicio externo. Recibirá el cuerpo de la respuesta (cadena), el código de estado (número) y el encabezado de la respuesta (objeto) como parámetros del servicio externo.
Si se ignora este parámetro, se crea un tono de kinton. 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 servicio externo. Recibirá el cuerpo de la respuesta (cadena) como parámetro del servicio externo.
Si se ignora este parámetro, se crea un tono de kinton. Se devolverá un objeto de promesa que se puede rechazar con el cuerpo de respuesta (cadena) de esta API.

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.upload('https://*****.***.net', 'POST', {}, {'format': 'RAW', 'value': SOME_BLOB_OBJECT}, 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.upload('https://*****.***.net', 'POST', {}, {'format': 'RAW', 'value': SOME_BLOB_OBJECT}).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
});

Limitaciones

  • Esta API se puede utilizar tanto en computadoras de escritorio como en teléfonos inteligentes.
  • El servicio 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.
  • El tamaño máximo del cuerpo de la respuesta desde el otro extremo del proxy es de 10 MB.
  • Se producirán errores si las líneas o los tamaños superan el máximo.
  • Los navegadores compatibles son: Últimas versiones de Mozilla Firefox, Google Chrome, Safari, iOS Safari y Android Chrome.
  • Se puede utilizar cualquier Content-Type.