Versionamento
O que pode mudar dentro da versão 1 da Direct API, o que o seu cliente precisa tolerar e como os modelos são adicionados e aposentados.
A versão está no caminho: /v1. Dentro da v1, as mudanças são aditivas: novas ferramentas, novos campos de entrada opcionais, novos campos de resposta, novos status, novos tipos de evento e novos códigos de erro.
O que o seu cliente precisa tratar
- Ignore os campos de resposta que você não conhece.
- Trate um status de geração que você não conhece como não final e continue acompanhando a geração.
- Conte com schemas de entrada que continuam estritos: um campo de entrada desconhecido é recusado, para que um erro de digitação nunca passe sem efeito em silêncio.
Mudanças incompatíveis
Uma mudança incompatível é lançada como /v2, com pelo menos 6 meses de convivência entre as versões e aviso a todas as organizações com uma chave ativa.
Modelos
- Modelos são adicionados e aposentados ao longo do tempo; Modelos sempre mostra o conjunto atual.
- Um ID de modelo nunca é reutilizado e nunca deixa de ser aceito. Um ID aposentado executa o seu substituto, e as respostas indicam o modelo que realmente foi executado.
- A Morphic só pode trocar o mecanismo por trás de um ID de modelo para melhorá-lo pelo mesmo preço ou por um preço menor, e anuncia a troca no catálogo de modelos.
Se você tiver algum problema ou alguma dúvida, entre em contato. Teremos prazer em ajudar. Escreva para nós em support@morphic.com.