Á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

IdentityIntegration

POST

/v2/auth/login

POST

/v3/auth/login

 

 

Breaking Change: Rota depreciada devido a nova regra incluída que considera o parâmetro de obrigatoriedade de autenticação por SSO para autenticação. Caso o parâmetro esteja ativo, não será possível usuários comuns se autenticarem via rota.

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 poder Publicar Documentos.

Obter dados do usuário
IdentityIntegration

GET

/v1/administrators/user

GET

/v2/administrators/user

 

API/ ServiçoRota depreciadaRota atualDepreciada emDescontinua emObservações

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. 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 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 anexos da publicação
SignIntegration 

GET

/v2/Anexos/{idArquivo}

GET

/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 da publicaçãoSignIntegration

POST

/v2/Anexos/{idArquivo}

POST

/documents/v1/publicacoes/{idDocumento}/anexos

10-02-2025

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 da publicaçãoSignIntegration

GET

/v2/Anexos/download/{idFileStream}

GET

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

10-02-2025

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 da publicaçãoSignIntegration

DELETE

/v2/Anexos/{idAnexo}

DELETE

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

10-02-2025

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 da publicaçãoSignIntegration

DELETE

/v2/Anexos/all/{idArquivo}

DELETE

/documents/v1/publicacoes/{idDocumento}/anexos

10-02-2025

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 arquivoStorage

POST

/api/Storage/list

POST

/documents/v1/envelopes/upload

23/05/23 

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

Login

IdentityIntegration

POST

/api/auth/login

POST

/identityintegration/v2/auth/login

06/04/2330/11/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/2230/11/25Alteraçõ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

GET

/documents/v1/publicacoes/{id}/download

27/04/2230/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/{id}

27/04/2230/11/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

GET

/v2/publicacoes/filter

POST

/documents/v4/publicacoes/pesquisas

27/04/2230/11/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.

Buscar e filtrar envelopes 

SignIntegration

GET

/v2/publicacoes/filter-basic

POST

/documents/v4/publicacoes/pesquisas

27/04/2230/11/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.

Buscar e filtrar envelopes 

Documents

POST

/v1/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

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

Buscar e filtrar envelopes 

Documents

POST

/v2/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

27/04/2230/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Buscar e filtrar envelopes 

Documents

POST

/v3/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

27/04/2230/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Criar novo usuário,  sendo um administrador

IdentityIntegration

POST

/v1/administrators/user

POST

/v2/administrators/user

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

Editar usuário existente, sendo um administrador

IdentityIntegration

PUT

/v1/administrators/user

PUT

/v2/administrators/user

 

 

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

Consulta envelope por id

(Autenticação por código)

Documents

GET

/v1/publicacoes/sem-cadastro/{id}

GET

/v2/publicacoes/sem-cadastro/{id}

02/04/2430/11/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/25

Manipulação de contatos e grupos de agenda

Contact

GET

/v1/contatos

GET

/v2/contatos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/contatos

DELETE

/v2/contatos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

PUT

/v1/contatos

PUT

/v2/contatos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

GET

/v1/contatos/usuario

GET

/v2/contatos

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

POST

/v1/contatos-grupo

POST

/v1/grupos/{id}/contatos

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contatos

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contato

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

GET

/v1/grupos

GET

/v2/grupos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

GET

/v1/grupos/usuario

GET

/v2/grupos

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

PUT

/v1/grupos

PUT

/v2/grupos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Manipulação de contatos e grupos de agenda

Contact

DELETE

/v1/grupos

DELETE

/v2/grupos/{id}

29/05/2330/11/25Alterações no Payload (contrato da API) e no Response (dados retornados).

Excluir publicação

Signintegration

DELETE

/v2/publicacoes

DELETE

documents/v1/publicacoes/{id}

12/12/2330/11/25Importante: a rota depreciada 

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

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

.

Excluir
Listar anexos da publicação
Signintegration
SignIntegration 
DELETE

GET

/v2/Anexos/

publicacoes

POST

documents

{idArquivo}

GET (Documents)

/v1/publicacoes/{

id

idDocumento}/

cancelar

anexos

12

12

23

 

30

25

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

Publicar documento

Incluir anexos na publicaçãoSignIntegration
Signintegration

POST

/v2/Anexos/

publicacoes

POST

documents

{idArquivo}

POST (Documents)

/v1/publicacoes

/{idDocumento}/anexos

 


 

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

...

titleHistórico completo

...

POST (antiga)
signintegration/v2/Publicacoes

POST (nova)
documents/v1/publicacoes

06/12/24

...

Baixar anexo da publicaçãoSignIntegration

GET

/v2/Anexos/download/{idFileStream}

GET (Documents)

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

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

Remover anexo da publicaçãoSignIntegration

DELETE

/v2/Anexos/{idAnexo}

DELETE (Documents

...

POST  (Depreciada)
/v2/Assinaturas/sem-cadastro

POST  (Nova)
/v2/Assinaturas/sem-cadastro

...

...

{idDocumento}/anexos/{idAnexo}

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

Remover todos  anexos da publicaçãoSignIntegration

DELETE

/v2/

...

Anexos/

...

all/{

...

idArquivo}

DELETE (Documents)

...

...

anexos

...

...

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

Publicar documento

Signintegration

POST

/v2/publicacoes

POST (Documents)

/v1/publicacoes

 

 

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

Criar usuário, sendo um administrador

...

IdentityIntegration

POST

/

...

v1/

...

administrators/

...

user

...

POST

...

...

v2/administrators/user

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

Editar usuário, sendo um administrador

IdentityIntegration

PUT

/v1/administrators/user

PUT

/v2/administrators/user

 

 

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

Consultar documento

(Autenticação por código)

Documents

...

GET

/v1/

...

GET (antiga)
/v1/contatos

DELETE (antiga)
/v1/contatos

PUT (antiga)
/v1/contatos

GET (antiga)
/v1/contatos/usuario

POST (antiga)
/v1/contatos-grupo

DELETE (antiga)
/v1/contatos-grupo

GET (antiga)
/v1/grupos

PUT (antiga)
/v1/grupos

DELETE (antiga)
/v1/grupos

GET (antiga)
/v1/grupos/usuario

...

DELETE (nova)
/v2/contatos/{id}

PUT (nova)
/v2/contatos/{id}

GET (nova)
/v2/contatos

GET (nova)
/v2/grupos/{id}

PUT (nova)
/v2/grupos/{id}

DELETE (nova)
/v2/grupos/{id}

GET (nova)
/v2/grupos

POST (nova)
/v1/grupos/{id}/contatos

DELETE (nova)
/v1/grupos/{id}/contatos

DELETE (nova)
/v1/grupos/{id}/contato

...

publicacoes/sem-cadastro/{id}

GET

/v2/publicacoes/sem-cadastro/{id}

 

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

Adição de regra para validar assinaturas manuscritas.

Excluir documento

Signintegration

DELETE

/v2/publicacoes

DELETE (Documents) 

/v1/publicacoes/{id}

 

Importante: a rota depreciada 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.

Excluir documento

Signintegration

DELETE

/v2/publicacoes

POST (Documents)

/v1/publicacoes/{id}/cancelar

Importante: a rota depreciada 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.

Consultar contato

Contact

GET

/v1/contatos

GET

/v2/contatos/{id}

 

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

Remover contato

Contact

DELETE

/v1/contatos

DELETE

/v2/contatos/{id}

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

Alterar contato

Contact

PUT

/v1/contatos

PUT

/v2/contatos/{id}

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

Listar todos contatos

Contact

GET

/v1/contatos/usuario

GET

/v2/contatos

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

Incluir contato em grupo

Contact

POST

/v1/contatos-grupo

POST

/v1/grupos/{id}/contatos

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

Remover contatos de grupo

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contatos

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

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/grupos

GET

/v2/grupos/{id}

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

Listar todos grupos

Contact

GET

/v1/grupos/usuario

GET

/v2/grupos

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

Alterar grupo

Contact

PUT

/v1/grupos

PUT

/v2/grupos/{id}

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

Remover grupo

Contact

DELETE

/v1/grupos

DELETE

/v2/grupos/{id}

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

POST

/api/Storage/list

POST (Documents)

/v1/envelopes/upload

 

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

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.

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

Upload de documentos

Storage

POST

/api/Storage

POST (Documents)

/v1/envelopes/upload

 

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

Download de documento

Storage

GET

/v1/Storage

GET (Documents)

/v1/publicacoes/{id}/download

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

Consultar documento

SignIntegration

GET

/v2/publicacoes/{id}

GET (Documents)

/v2/publicacoes/{id}

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.

Consultar documento

Documents

GET

/v1

...

/publicacoes/{id}

GET

/v2/publicacoes/

...

{id}

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.

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

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.

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

Listar e filtrar documentos 

Documents

POST

/v1/

...

publicacoes/pesquisas

POST

/

...

...

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

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

Listar e filtrar documentos 

...

Documents

...

POST

/

...

v2/

...

publicacoes/

...

pesquisas

...

POST

...

...

...

...

pesquisas

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

Listar e filtrar documentos 

Documents

POST

/v3/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

...

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

...