Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Informações
titleDepreciação e desativação de apis

Após a depreciação de uma API é recomendado que as integrações atualizem suas implementações para obter mais desempenho e segurança. Sendo assim, sempre que se deparar com a expressão depreciada/deprecated dentro desta documentação (ou Swagger), saiba que esta rota será descontinuada em breve. Rotas depreciadas permanecerão funcionais por no mínimo 12 meses. Após esse período poderão ser inativadas.

A lista abaixo contém as rotas/ APIs que serão desativadas a partir de 01/11/26 em diante; é importante que todos os produtos se programem para evitar impactos nos clientes!

Informações
titleTela de autenticação externa

Ainda no tema, vamos descontinuar uma tela de autenticação externa, utilizada por alguns produtos integradores. As integrações que desejam continuar realizando autenticações no TAE precisam desenvolver uma interface visual própria para isso, além de consumir nossas APIs que tratam desse contexto.

A tela em questão foi depreciada em 06/04/2023, será descontinuada em 01/03/2027 e era acessada por um dos links abaixo:


Expandir
titleRepresentação visual

Image Added

DescriçãoAPI/ ServiçoRota depreciadaRota atualDepreciada emDescontinua emObservações

Contagem de documentos por status

SignIntegration

GET

/v2/publicacoes/dashboard

N/A

 

 

Rota depreciada pois deve ser usada apenas internamente pelo produto.

Autenticação de usuário

integrador

IdentityIntegration

POST

/v2/auth/login

POST

/

identityintegration/

v3/auth/login

 

21

08

26

 

Breaking Change: Rota depreciada devido a nova regra incluída que considera o parâmetro de obrigatoriedade de autenticação por SSO para

realização do login

autenticação. Caso o parâmetro esteja ativo, não será possível usuários comuns se autenticarem via rota

de integração

.

A configuração de permissões dos Usuários de Serviço pode ajudar a contornar essa quebra de fluxo, já que eles passam a

ter permissão de

poder Publicar Documentos.

Obter dados do usuário
(por id e por email)

IdentityIntegration

GET

/v1/administrators/user

GET

/identityintegration

/v2/administrators/user

 

19

05

26

Alterações no Payload (contrato da API) e no Response (dados retornados)

, além da mudança de serviço

.

Manipulação de
Listar anexos da publicação
SignIntegration 

GET

/v2/Anexos/{idArquivo}

GET (Documents)

/

documents/

v1/publicacoes/{idDocumento}/anexos

 

10

02

26

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de
Incluir anexos
da
na publicaçãoSignIntegration

POST

/v2/Anexos/{idArquivo}

POST (Documents)

/documents

/v1/publicacoes/{idDocumento}/anexos

-

-

 

10


02

26

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de anexos
Baixar anexo da publicaçãoSignIntegration

GET

/v2/Anexos/download/{idFileStream}

GET (Documents)

/documents

/v1/publicacoes/{idDocumento}/anexos/{idAnexo}

-

-

10

02

26

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de anexos
Remover anexo da publicaçãoSignIntegration

DELETE

/v2/Anexos/{idAnexo}

DELETE (Documents)

/

documents/

v1/publicacoes/{idDocumento}/anexos/{idAnexo}

-

-

10

02

26

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de
Remover todos  anexos da publicaçãoSignIntegration

DELETE

/v2/Anexos/all/{idArquivo}

DELETE (Documents)

/documents

/v1/publicacoes/{idDocumento}/anexos

-

-

10

02

26

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Upload de arquivo

Publicar documento

Signintegration

Storage

POST

/

api

v2/

Storage/list

publicacoes

POST (Documents)

/documents

/v1/

envelopes/upload

publicacoes

23

05

23 

 

30

25

 

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.
Login

Criar usuário, sendo um administrador

IdentityIntegration

POST

/

api

v1/

auth

administrators/

login

user

POST

/

identityintegration/

v2/

auth

administrators/

login

user

06

04

23

30

25

Importante: a rota depreciada retornava tokens em formato JWT; a partir da nova os tokens serão JWE.

Alterações no Payload (contrato da API) e no Response (dados retornados)
, além da mudança de serviço
.

Upload de arquivo

Storage

POST

/api/Storage

POST

/documents/v1/envelopes/upload

27/04/22

Editar usuário, sendo um administrador

IdentityIntegration

PUT

/v1/administrators/user

PUT

/v2/administrators/user

 

 

30/11/25

Alterações no Payload (contrato da API) e no Response (dados retornados)
, além da mudança de serviço
.

Download arquivo

Storage

GET

/v1/Storage

Consultar documento

(Autenticação por código)

Documents

GET

/

documents/

v1/publicacoes/sem-cadastro/{id}

/download27/04/22

30/11/25Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Consulta envelope por id

SignIntegration

GET

/v2/publicacoes/

{id}

GET

/documents/v2/publicacoes/

sem-cadastro/{id}

27

22

 

30

25

Importante: a rota depreciada não retorna documentos em status Cancelado.

Alterações no Payload (contrato da API) e no Response (dados retornados)

, além da mudança de serviço

.

Consulta envelope por id

Documents

GET

/v1/publicacoes/{id}

GET

/v2/publicacoes/{id}

27/04/2230/11/25Importante: a rota depreciada não retorna documentos em status Cancelado.

Buscar e filtrar envelopes 

SignIntegration

Realizar assinatura

(Autenticação por código)

Signintegration

POST

/v2/Assinaturas/sem-cadastro

POST

/v3/Assinaturas/sem-cadastro

Adição de regra para validar assinaturas manuscritas.

Excluir documento

Signintegration

DELETE

GET

/v2/publicacoes

/filterPOST

DELETE (Documents) 

/

documents/v4

v1/publicacoes/

pesquisas

{id}

27

04

22

 

30

25

Importante: a rota depreciada

não retorna documentos em status Cancelado

foi ajustada para tratar os casos de Exclusão e Cancelamento. A nova rota apenas exclui os documentos.

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Buscar e filtrar envelopes 

SignIntegration

Excluir documento

Signintegration

DELETE

GET

/v2/publicacoes

/filter-basic

POST (Documents)

/

documents

v1/

v4

publicacoes/

publicacoes

{id}/

pesquisas

cancelar

27

04

22

30

25

Importante: a rota depreciada

não retorna documentos em status Cancelado

foi ajustada para tratar os casos de Exclusão e Cancelamento. A nova rota apenas cancela os documentos.

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Buscar e filtrar envelopes 

Documents

Consultar contato

Contact

GET

POST

/v1/

publicacoes/pesquisas

contatos

POST

GET

/

v4

v2/

publicacoes

contatos/

pesquisas

{id}

27

04

22

 

30

25Importante: a rota depreciada não retorna documentos em status Cancelado.

Alterações no Payload (contrato da API) e no Response (dados retornados).

Remover contato

Contact

DELETE

/v1/contatos

DELETE

/v2/contatos/{id}

Buscar e filtrar envelopes 

Documents

POST

/v2/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

27/04/2230/11/25

Alterações no Payload (contrato da API) e no Response (dados retornados).

Buscar e filtrar envelopes 

Documents

Alterar contato

Contact

PUT

POST

/

v3

v1/

publicacoes/pesquisas

contatos

POST

PUT

/

v4

v2/

publicacoes

contatos/

pesquisas

{id}

27

04

22

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados).

Criar novo usuário,  sendo um administrador

IdentityIntegration

Listar todos contatos

Contact

GET

POST

/v1/

administrators

contatos/

user

usuario

POST

GET

/v2/

administrators/user

contatos

10

11

2024

Alterações no Payload (contrato da API) e no Response (dados retornados).

Editar usuário existente, sendo um administrador

IdentityIntegration

Incluir contato em grupo

Contact

POST

PUT

/v1/

administrators/user

PUT

/v2/administrators/user

contatos-grupo

POST

/v1/grupos/{id}/contatos

 

 

Alterações no Payload (contrato da API) e no Response (dados retornados).

Consulta envelope por id

(Autenticação por código)

Documents

Remover contatos de grupo

Contact

DELETE

GET

/v1/

publicacoes/sem-cadastro/{id}

contatos-grupo

DELETE

/v1/grupos/

GET

/v2/publicacoes/sem-cadastro/

{id}/contatos

02

04

24

30

25

Importante: a rota depreciada não retorna documentos em status Cancelado.

Alterações no Payload (contrato da API) e no Response (dados retornados).

Realizar assinatura

(Autenticação por código)

Signintegration

POST

/v2/Assinaturas/sem-cadastro

POST

/v3/Assinaturas/sem-cadastro

02/04/2430/11/25Manipulação de contatos e grupos de agenda

Remover contato de grupo

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contato

Alterações no Payload (contrato da API) e no Response (dados retornados).

Consultar grupo

Contact

GET

/v1/

contatos

grupos

GET

/v2/

contatos

grupos/{id}

23

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados).
Manipulação de contatos e grupos de agenda

Listar todos grupos

Contact

DELETE

GET

/v1/grupos/

contatos

usuario

DELETE

GET

/v2/

contatos/{id}

grupos

23

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados).
Manipulação de contatos e grupos de agenda

Alterar grupo

Contact

PUT

/v1/

contatos

grupos

PUT

/v2/

contatos

grupos/{id}

23

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados).
Manipulação de contatos e grupos de agenda

Remover grupo

Contact

GET

DELETE

/v1/

contatos/usuario

grupos

GET

DELETE

/v2/grupos/

contatos

{id}

23

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Upload de documentosStorage
Contact

POST

/

v1/contatos-grupo

api/Storage/list

POST (Documents)

/v1/

grupos/{id}/contatos

envelopes/upload

29

23

 

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contatos

29/05/23

Autenticação de usuário

IdentityIntegration

POST

/api/auth/login

POST

/v2/auth/login

 

Importante: a rota depreciada retornava tokens em formato JWT; a partir da nova os tokens serão JWE.

30/11/25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/contatos-grupo

Upload de documentos

Storage

POST

/api/Storage

POST (Documents)

DELETE

/v1/

grupos/{id}/contato

envelopes/upload

 

29/05/2330

25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Download de documento

Storage
Contact

GET

/v1/

grupos

Storage

GET (Documents)

/

v2

v1/

grupos

publicacoes/{id}/download

29

05

23

30

25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Consultar documento

SignIntegration

Contact

GET

/

v1

v2/

grupos

publicacoes/

usuario

{id}

GET (Documents)

/v2/publicacoes/

grupos

{id}

29

05

23

30

25

Importante: a rota depreciada não retorna documentos em status Cancelado.

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Contact

Consultar documento

Documents

GET

PUT

/v1/

gruposPUT

publicacoes/{id}

GET

/v2/

grupos

publicacoes/{id}

29/05/23

Importante: a rota depreciada não retorna documentos em status Cancelado.

Listar e filtrar documentos 

SignIntegration

GET

/v2/publicacoes/filter

POST (Documents)

/v4/publicacoes/pesquisas

Importante: a rota depreciada não retorna documentos em status Cancelado.

30/11/25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/grupos

DELETE

/v2/grupos/{id}

29/05/23

Listar e filtrar documentos 

SignIntegration

GET

/v2/publicacoes/filter-basic

POST (Documents)

/v4/publicacoes/pesquisas

Importante: a rota depreciada não retorna documentos em status Cancelado.

30/11/25

Alterações no Payload (contrato da API) e no Response (dados retornados), além da mudança de serviço.

Excluir publicação

Signintegration

Listar e filtrar documentos 

Documents

POST

DELETE

/

v2

v1/publicacoes/pesquisas

DELETE

POST

documents

/

v1

v4/publicacoes/

{id}

pesquisas

12

12

23

30

25

Importante: a rota

depreciada 

depreciada não retorna documentos em status Cancelado.

Alterações no Payload (contrato da API) e no Response (dados retornados)

, além da mudança de serviço

.

Excluir publicação

Signintegration

Listar e filtrar documentos 

Documents

POST

DELETE

/v2/publicacoes/pesquisas

POST

documents

/

v1

v4/publicacoes/

{id}/cancelar

pesquisas

12/12/2330

25

Alterações no Payload (contrato da API) e no Response (dados retornados)
, além da mudança de serviço
.

Publicar documento

Listar e filtrar documentos 

Documents

Signintegration

POST

/

v2

v3/publicacoes/pesquisas

POST

documents

/

v1

v4/publicacoes/pesquisas

06

12

2024 

 

Alterações no Payload (contrato da API) e no Response (dados retornados)
, além da mudança de serviço
.