Requisições com invokeURL

InvokeUrl é um cliente HTTP que permite  acessar e modificar:

• recursos da web usando chamadas HTTP.
• dados de um serviço Zoho de outro serviço Zoho usando a URL especificada em sua API
• dados de um serviço de terceiros conectado ao seu serviço Zoho usando o URL especificado em sua API.

Observações:

• Esta tarefa lançará um “erro de tempo limite de soquete” se o recurso da web / API demorar mais de 40 segundos para responder. 
• No Zoho Creator, você pode baixar arquivos de tamanho de até 50 MB usando esta tarefa.
• Em outros serviços além do Zoho Creator, você pode baixar arquivos de domínio Zoho de até  15 MB e outros arquivos de domínio de até 5 MB .

Sintaxe

response = invokeUrl
[ 
 url: <url_value> 
 type: [<type_value>] 
 headers: [<headers_value>] 
 content-type: [<content_type_value>] 
 parameters: [<parameters_value>] 
 files: [<files_value>] 
 connection: [<connection_name>] 
 detailed: [<detailed_value>] 
 response-format: [<response_format_value>] 
 response-decoding: [<encoding_format_value>] 
];

<response> A variável que conterá a resposta retornada.

<url_value> O URL da solicitação cujos recursos precisam ser acessados.

<type_value> Método de solicitação HTTP, os valores permitidos são:

• GET (valor padrão)
• POST
• PUT
• PATCH
• DELETE

<headers_value> Os atributos ou os valores do cabeçalho.

<content_type_value>  O tipo de conteúdo que precisa ser enviado no corpo da solicitação HTTP.
Valores permitidos: qualquer tipo de conteúdo válido. Por exemplo, multipart / form-data, application / x-www-form-urlencoded, application / json, etc.

<parameters_value> O corpo da solicitação.

Envie vários tipos de corpo de solicitação usando invokeUrl:

• Raw: os dados TEXT para este parâmetro serão enviados como tipo raw. 
• x-www-form-urlencoded: os dados KEY-VALUE para este parâmetro serão enviados como tipo x-www-form-urlencoded . 
• Dados do formulário: os dados do VALOR-CHAVE para este parâmetro serão enviados como tipo de dados do formulário multipartes, se o valor do   parâmetro do tipo de conteúdo for especificado como  dados do formulário / multipartes .

  Observação:

  • Se o valor do parâmetro content-type não for especificado como  multipart / form-data , os dados KEY-VALUE serão tratados como tipo  x-www-form-urlencoded  .
  • No  Zoho Creator , os valores multipart / form-data devem ser especificados no  parâmetro files 
• Binário: os dados FILE são enviados como tipo binário.

  Observação:

  • O valor do  parâmetro <content-type> deve ser especificado como  application / octet-stream , para reconhecer que o corpo é enviado como tipo binário.
  • O tipo binário não é aplicável ao Zoho Creator.

<files_value>  No  Zoho Creator , se o corpo da solicitação precisa ser enviado como dados de formulário de várias partes, os valores precisam ser fornecidos a este parâmetro.

Observação:

• Apenas os arquivos recebidos como resposta de uma tarefa invokeUrl podem ser anexados.
• Este parâmetro também pode ser usado em outros serviços além do Zoho Creator. No entanto, para enviar dados de formulário multipartes de  serviços diferentes do Zoho Creator , recomendamos que você forneça os valores como VALOR-CHAVE para o  parâmetro body enquanto especifica o  parâmetro de tipo de conteúdo como  multipart / form-data .
• A função toFile pode ser usada aqui. Por exemplo, você pode pegar um valor de texto no formato csv e usar a função ‘toFile’ para passá-lo como um arquivo csv. Observe que esta função não é aplicável ao Zoho Creator.
• No Zoho Creator, o texto de entrada que será convertido em arquivo não pode ter mais de 50 MB .

Formato para enviar dados KEY-VALUE,

• Se o valor associado com a chave é FILE:

• Se o valor associado à chave for TEXT:

O exemplo a seguir busca uma imagem da web usando seu URL: