Á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

/identityintegration

/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

 

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

Listar anexos da publicação
SignIntegration 

GET

/v2/Anexos/{idArquivo}

GET (Documents)

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

Incluir anexos na publicaçãoSignIntegration

POST

/v2/Anexos/{idArquivo}

POST (Documents)

/

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.

Baixar anexo da publicaçãoSignIntegration

GET

/v2/Anexos/download/{idFileStream}

GET (Documents)

/

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)

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

DELETE

/v2/Anexos/all/{idArquivo}

DELETE (Documents)

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

Upload de documentos

Publicar documento

Signintegration

Storage

POST

/

api

v2/

Storage/list

publicacoes

POST (Documents)

/documents

/v1/

envelopes/upload

publicacoes

25

05

2023

 

 

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

Criar usuário, sendo um administrador

IdentityIntegration

POST

/

api

v1/

auth

administrators/

login

user

POST

/identityintegration

/v2/

auth

administrators/

login

user

06

04

2023 

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

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)
, além da mudança de serviço
.
Download de

Consultar documento

Storage

(Autenticação por código)

Documents

GET

/v1/Storage

GET

/documents

/v1/publicacoes/sem-cadastro/{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

sem-cadastro/{id}

27

2022

 

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}

.

Realizar assinatura

(Autenticação por código)

Signintegration

POST

/v2/Assinaturas/sem-cadastro

POST

/v3/Assinaturas/sem-cadastro

Importante: a rota depreciada não retorna documentos em status Cancelado.
Adição de regra para validar assinaturas manuscritas.

Excluir documento

Signintegration

DELETE

Listar e filtrar documentos 

SignIntegration

GET

/v2/publicacoes

/filterPOST

DELETE (Documents) 

/

documents/v4

v1/publicacoes/

pesquisas

{id}

27

04

2022

 

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.

Listar e filtrar documentos 

SignIntegration

Excluir documento

Signintegration

DELETE

GET

/v2/publicacoes

/filter-basic

POST (Documents)

/

documents

v1/

v4

publicacoes/

publicacoes

{id}/

pesquisas

cancelar

27

04

2022

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.

Listar e filtrar documentos 

Documents

Consultar contato

Contact

GET

POST

/v1/

publicacoes/pesquisas

contatos

POST

GET

/

v4

v2/

publicacoes

contatos/

pesquisas

{id}

27

04

2022

 

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

Remover contato

Contact

DELETE

/

v2

v1/

publicacoes/pesquisas

contatos

POST

DELETE

/

v4

v2/

publicacoes

contatos/

pesquisas

{id}

27

04

2022

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

Listar e filtrar documentos 

Documents

POST

Alterar contato

Contact

PUT

/

v3

v1/

publicacoes/pesquisas

contatos

POST

PUT

/

v4

v2/

publicacoes

contatos/

pesquisas

{id}

27

04

2022

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

Criar 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, 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).

Consultar documento

(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

2024 

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

Remover contato de grupo

Contact

DELETE

/v1/contatos-grupo

DELETE

/v1/grupos/{id}/contato

Adição de regra para validar assinaturas manuscritas
Alterações no Payload (contrato da API) e no Response (dados retornados).

Consultar

contato

grupo

Contact

GET

/v1/

contatos

grupos

GET

/v2/

contatos

grupos/{id}

 

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

Listar todos grupos

Contact

DELETE

GET

/v1/

contatos

grupos/usuario

DELETE

GET

/v2/

contatos/{id}

grupos

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

Alterar

contato

grupo

Contact

PUT

/v1/

contatos

grupos

PUT

/v2/

contatos

grupos/{id}

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

Remover grupo

Contact

GET

DELETE

/v1/

contatos/usuario

grupos

GET

DELETE

/v2/grupos/

contatos

{id}

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

Incluir contato em grupo

Upload de documentosStorage
Contact

POST

/

v1/contatos-grupo

api/Storage/list

POST (Documents)

/v1/

grupos/{id}/contatos

envelopes/upload

29

 

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

Autenticação de

grupo

usuário

Contact
IdentityIntegration
DELETE

POST

/api/

v1

auth/

contatos-grupo

login

DELETE

POST

/

v1

v2/

grupos/{id}/contatos

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.

Remover contato

Upload de

grupo

documentos

Contact
Storage
DELETE

POST

/

v1

api/

contatos-grupoDELETE

Storage

POST (Documents)

/v1/

grupos/{id}/contato

envelopes/upload

 

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

Consultar grupo

Download de documento

Storage
Contact

GET

/v1/

grupos

Storage

GET (Documents)

/

v2

v1/

grupos

publicacoes/{id}/download

29

05

2023

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

Listar todos grupos

Consultar documento

SignIntegration

Contact

GET

/

v1

v2/

grupos

publicacoes/

usuario

{id}

GET (Documents)

/v2/publicacoes/

grupos

{id}

29

05

2023

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.

Alterar grupo

Consultar documento

Contact

Documents

PUT

GET

/v1/publicacoes/

grupos

{id}

PUT

GET

/v2/

grupos

publicacoes/{id}

29

05

2023

Alterações no Payload (contrato da API) e no Response (dados retornados).
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

Remover grupo

Contact

DELETE

/v1/grupos

DELETE

/v2/grupos/{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.

Excluir documento

Signintegration

Listar e filtrar documentos 

SignIntegration

GET

DELETE

/v2/publicacoes

DELETE

documents/v1

/filter-basic

POST (Documents)

/v4/publicacoes/

{id}

pesquisas

12

12

2023 

Importante: a rota depreciada

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

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 documento

Signintegration

Listar e filtrar documentos 

Documents

POST

DELETE

/

v2

v1/publicacoes/pesquisas

POST

documents

/

v1

v4/publicacoes/

{id}/cancelar

pesquisas

Importante: a rota depreciada

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

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

.

Publicar documento

Listar e filtrar documentos 

Documents

Signintegration

POST

/v2/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
.

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).