Adicionar anexos a uma solicitação

Como adicionar um anexo a uma tarefa ou solicitação?

1. Autenticação: Primeiro obtenha um token de autenticação com permissão de realizar essa operação;;

2. Obtenha o instanceTaskId: Obtenha o identificador da instância de tarefa através de consultas de API conforme exemplos explicados em Listar minhas tarefas pendentes

3. Envie a requisição: Utilize o endpoint Adicionar anexos a uma solicitação. Lembre-se de substituir seu_endereco.do.zeev pelo endereço utilizado para acessar o Zeev;

O tamanho máximo do arquivo deve ser de 50mb

Adicionar um anexo de no máximo 50mb a uma instância de tarefa por código identificador da instância da tarefa (Auth)

post

Autorizações

AuthorizationstringObrigatório

Utilize um token válido de usuário para realizar a requisição

Corpo

instanceTaskIdinteger · int32 · mín: 1 · máx: 2147483647Obrigatório

Número identificador da instância de tarefa

fileNamestring · máx: 255Obrigatório

Nome do anexo a ser inserido

resumestring · máx: 1024Opcional

Texto descritivo resumo do anexo

requesterCanSeebooleanOpcional

Indicador se a pessoa solicitante pode ver esse anexo

docTypestring · máx: 255Opcional

Descritivo do tipo de anexo

base64ContentstringObrigatório

Conteúdo em base64 do anexo

Respostas

200

Sucesso

idinteger · int32Opcional

Id do arquivo adicionado

fileNamestringOpcional

Nome do arquivo

400

Solicitação ou dados da solicitação são inválidas

401

Pessoa não autorizada

403

Pessoa não tem permissão de executar essa operação

404

O registro não foi encontrado

429

Muitas requisições em um determinado período de tempo

500

Ocorreu algum erro interno no servidor

post/api/2/files/instance-task

POST /api/2/files/instance-task HTTP/1.1
Host: seu_endereco.do.zeev
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 117

{
  "instanceTaskId": 1,
  "fileName": "text",
  "resume": "text",
  "requesterCanSee": true,
  "docType": "text",
  "base64Content": "text"
}

{
  "id": 1,
  "fileName": "text"
}

O parâmetro fileName precisa vir, obrigatoriamente, acompanhado de sua extensão. Já o parâmetro docType é o descritivo do documento, como CPF, Contrato, Declaração, etc.

Exemplo de requisição para adicionar arquivo a uma instância de tarefa

Node.js

const myHeaders = new Headers();
myHeaders.append("Accept", "application/json");
myHeaders.append("Content-Type", "application/json");
myHeaders.append("Authorization", "Bearer TOKEN_DO_USUARIO");

const raw = JSON.stringify({
  "instanceTaskId": 826180262,
  "fileName": "Contrato.tif",
  "base64Content": "iVBORw0KGgoAAAANSUhEUgAAAMgAAAAyCAIAAACiUjI+AAAAAElFTkSuQmCC",
  "resume": "Resumo sobre o arquivo",
  "requesterCanSee": false
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw
};

try {
  const response = await fetch("https://seu_endereco.do.zeev/api/2/files/instance-task", requestOptions);
  const result = await response.json();
  console.log(result)
} catch (error) {
  console.error(error);
};

---

Links relacionados:

• O que é preciso para fazer integrações do Zeev para outros sistemas?

• Como autenticar nas APIs do Zeev

• Como controlar o volume máximo de requisições à APIs

• Como acessar o Swagger / OpenAPI