Á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!

0
Table Filterinfo
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

inversefalse
datefilterDepreciada em
ddSeparator
sparkNameSparkline
hidePaneTable header
isNewfalse
separatorPoint (.)
labelsDepreciada em
default->
ddOperatorcell-width
datepatternyy-mm-dd
hideFilters
id1758827265172
isORAND
formatVersion2
order

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

 

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

Listar anexos da publicação
SignIntegration 

GET

/v2/Anexos/{idArquivo}

GET (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)

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

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

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

/v1/publicacoes/{idDocumento}/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)

...

...

...

...

...

 

 

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

/

...

...

...

...

...

...

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)

...

.

...

Upload de documentos

...

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)

...

.

...

Consultar documento

...

GET

/v1/Storage

GET

...

(Autenticação por código)

Documents

GET

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

...

...

...

Consultar documento

...

...

GET

...

...

...

 

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

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

...

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

...

...

Adição de regra para validar assinaturas manuscritas.

Excluir documento

Signintegration

DELETE

...

Listar e filtrar documentos 

...

SignIntegration

...

/v2/publicacoes

...

DELETE (Documents) 

/

...

...

...

...

...

 

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.

...

Listar e filtrar documentos 

...

SignIntegration

Excluir documento

Signintegration

DELETE

...

/v2/publicacoes

...

POST (Documents)

/

...

...

...

...

...

...

...

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.

...

Listar e filtrar documentos 

...

Documents

Consultar contato

Contact

GET

...

/v1/

...

contatos

...

GET

/

...

...

...

...

...

...

 

...

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

...

Listar e filtrar documentos 

...

Documents

Remover contato

Contact

DELETE

...

/

...

v1/

...

contatos

...

DELETE

/

...

...

...

...

...

...

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

...

Listar e filtrar documentos 

...

Documents

...

Alterar contato

Contact

PUT

/

...

v1/

...

contatos

...

PUT

/

...

...

...

...

...

...

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

...

Criar usuário, sendo um administrador

...

Listar todos contatos

Contact

GET

...

/v1/

...

contatos/

...

usuario

...

GET

/v2/

...

...

...

...

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

...

Editar usuário, sendo um administrador

...

Incluir contato em grupo

Contact

POST

...

/v1/

...

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

...

/v1/

...

contatos-grupo

DELETE

/v1/grupos/

...

GET

...

...

...

...

...

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

...

...

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

...

Incluir contato em grupo

Upload de documentosStorage

...

POST

/api/

...

Storage/

...

list

POST (Documents)

/v1/

...

...

 

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

...

...

...

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)

...

...

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

...

GET

/v1/

...

Storage

GET (Documents)

/

...

...

...

...

...

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

...

GET

/

...

v2/

...

publicacoes/

...

{id}

GET (Documents)

/v2/

...

...

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/

...

...

...

...

...

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

...

/v2/publicacoes

...

DELETE

...

/filter-basic

POST (Documents)

/v4/publicacoes/

...

...

...

...

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 

Documents

POST

...

/

...

v1/publicacoes/pesquisas

POST

...

...

...

pesquisas

...

Importante: a rota depreciada

...

não retorna documentos em status Cancelado.

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

...

.

...

Publicar documento

Listar e filtrar documentos 

Documents

...

POST

/v2/publicacoes/pesquisas

POST

...

...

...

...

...

...

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