API 3.0 é a versão padrão da API e recomendamos que você use esta versão ao construir novas integrações. Continuaremos a oferecer suporte à API 2.0 e 2.1 no futuro previsível e forneceremos um aviso com pelo menos 12 meses de antecedência antes de desligar essas versões.
Aprendemos muito durante a transição da API 1.2 para a API 2. Desta vez, tornamos a atualização muito mais fácil de gerenciar. API 3.0 adiciona novas funcionalidades, ao mesmo tempo que modifica a funcionalidade existente quando absolutamente necessário. Isso significa que os integradores devem ser capazes de mudar para a nova API com o mínimo de confusão. Isso também significa que, embora recomendemos que você comece a planejar sua atualização o mais rápido possível para que sua organização e pesquisadores possam se beneficiar dos novos recursos, você tem bastante flexibilidade para decidir quando atualizar para 3.0.
A pequena lista de mudanças potencialmente importantes está em nossas notas de versão da API aqui e a aqui. Existem algumas mudanças em torno dos campos opcionais / obrigatórios, as enumerações JSON foram ligeiramente modificadas e também temos uma pequena refatoração de nossos esquemas XML, adicionando alguns novos campos para conter os metadados necessários para a nova funcionalidade.