Á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

GET

/v1/Storage

GET

/documents

(Autenticação por código)

Documents

GET

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

Listar e filtrar documentos 

Documents

POST

/v2/publicacoes/pesquisas

POST

/v4/publicacoes/pesquisas

 

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

Listar e filtrar documentos 

Documents

POST

Remover contato

Contact

DELETE

/

v3

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

Criar usuário, sendo um administrador

IdentityIntegration

Alterar contato

Contact

PUT

POST

/v1/

administrators/user

contatos

POST

PUT

/v2/

administrators

contatos/

user

{id}

10

11

2024

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

Editar usuário, sendo um administrador

IdentityIntegration

Listar todos contatos

Contact

GET

PUT

/v1/

administrators

contatos/

user

usuario

PUT

GET

/v2/

administrators/user

contatos

10

11

2024 

 

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

Consultar documento

(Autenticação por código)

Documents

Incluir contato em grupo

Contact

POST

GET

/v1/

publicacoes/sem-cadastro/{id}

contatos-grupo

POST

/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 contatos de grupo

Contact

DELETE

Consultar contato

Contact

GET

/v1/contatos-grupo

GET

DELETE

/

v2

v1/

contatos

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

/

v2

v1/

contatos

grupos/{id}/contato

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

Consultar grupo

Contact

PUT

GET

/v1/

contatos

grupos

PUT

GET

/v2/

contatos

grupos/{id}

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

Listar todos

contatos

grupos

Contact

GET

/v1/

contatos

grupos/usuario

GET

/v2/

contatos

grupos

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

Alterar grupo

Contact

POST

PUT

/v1/

contatos-grupo

grupos

POST

PUT

/

v1

v2/grupos/{id}

/contatos

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

Remover

contatos de

grupo

Contact

DELETE

/v1/

contatos-grupo

grupos

DELETE

/

v1

v2/grupos/{id}

/contatos

Alterações no Payload (contrato da API) e no Response (dados retornados).
Remover contato
Upload de
grupo
documentos
Contact
Storage
DELETE

POST

/

v1/contatos-grupoDELETE

api/Storage/list

POST (Documents)

/v1/

grupos/{id}/contato

envelopes/upload

29

 

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

Consultar grupo

Contact

GET

/v1/grupos

Autenticação de usuário

IdentityIntegration

POST

/api/auth/login

POST

GET

/v2/

grupos

auth/

{id}

login

29

05

 

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.

Listar todos grupos

Contact

Upload de documentos

Storage

POST

GET

/

v1

api/

grupos/usuario

GET

/v2/grupos

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.

Alterar grupo

Contact

Download de documento

Storage

GET

PUT

/v1/

gruposPUT

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.
Remover grupo

Consultar documento

Contact

SignIntegration

DELETE

GET

/v2/

v1

publicacoes/

gruposDELETE

{id}

GET (Documents)

/v2/

grupos

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

Excluir

Consultar documento

Signintegration

Documents

DELETE

GET

/

v2

v1/publicacoes/{id}

DELETE

GET

documents

/

v1

v2/publicacoes/{id}

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.

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.

Excluir documento

Signintegration

Listar e filtrar documentos 

SignIntegration

GET

DELETE

/v2/publicacoes/filter-basic

POST (Documents)

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

.

.

Listar e filtrar documentos 

Documents

POST

/v1/publicacoes/pesquisas

POST

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

Listar e filtrar documentos 

Documents

Publicar documento

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