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
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
|
|
Solicitud de ejemplo mediante promesas
|
|
Notas
- Se puede utilizar cualquier Content-Type.
- Especificación de un valor inexistente
url
devolverá un código de estado de error de503 (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
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 yTransfer-Encoding
los encabezados se agregan automáticamente si el método HTTP se establece enPOST
oPUT
. - Configuración explícita
headers
provocará un error.