Em geral, haverá três versões compatíveis da API DCM/DFA Reporting and Trafficking
a qualquer momento. Quando uma nova versão for lançada, uma data de desativação será anunciada para a
versão mais antiga. Uma versão será considerada com uso suspenso quando for anunciada uma
data de desativação para ela.
O período de suspensão de uso para a maioria das versões será de aproximadamente sete meses.
As versões com uso suspenso permanecem disponíveis até a data programada de desativação,
mas é recomendado que os usuários utilizem o período de suspensão de uso para migrar para a
versão mais recente. Após a data de desativação, as versões com uso suspenso não estarão mais disponíveis.
O que acontece quando uma versão é desativada?
Quando uma versão é desativada, todas as solicitações recebidas são recusadas com a resposta de erro HTTP 403: Forbidden. Esses erros são acompanhados por uma mensagem de alerta que informa ao usuário que a versão não é mais compatível:
{
"error": {
"errors": [
{
"domain": "global",
"reason": "forbidden",
"message": "3140 : Version v2.x of the DCM/DFA Trafficking and Reporting API is no longer supported. Please upgrade to the latest version of the API."
}
],
"code": 403,
"message": "3140 : Version v2.x of the DCM/DFA Trafficking and Reporting API is no longer supported. Please upgrade to the latest version of the API."
}
}
Após algum tempo, a versão é totalmente desativada e fica inacessível. Nesse ponto, todas as solicitações referentes à versão recebem uma resposta de erro HTTP 404: Not Found genérica.
Veja abaixo a programação das datas de suspensão de uso e desativação anunciadas
no momento:
| Versão da API |
Data da suspensão de uso |
Data da desativação |
| v3.3 |
|
|
