Versionado
Qué puede cambiar dentro de la versión 1 de la Direct API, qué debe tolerar su cliente y cómo se añaden y retiran los modelos.
La versión va en la ruta: /v1. Dentro de v1, los cambios son aditivos: herramientas nuevas, nuevos campos de entrada opcionales, nuevos campos de respuesta, nuevos estados, nuevos tipos de evento y nuevos códigos de error.
Qué debe gestionar su cliente
- Ignore los campos de respuesta que no conozca.
- Trate un estado de generación que no conozca como no final y siga la generación.
- Cuente con que los esquemas de entrada sigan siendo estrictos: un campo de entrada desconocido se rechaza, así que una errata nunca pasa inadvertida sin hacer nada.
Cambios incompatibles
Un cambio incompatible se publica como /v2, con al menos 6 meses de convivencia y aviso a todas las organizaciones con una clave activa.
Modelos
- Los modelos se añaden y se retiran con el tiempo; Modelos muestra siempre el conjunto actual.
- Un id de modelo nunca se reutiliza ni deja de aceptarse. Un id retirado ejecuta su reemplazo, y las respuestas nombran el modelo que realmente se ejecutó.
- Morphic solo puede cambiar el motor que hay detrás de un id de modelo para mejorarlo al mismo precio o a uno inferior, y lo anuncia en el catálogo de modelos.
Si tiene algún problema o alguna pregunta, no dude en ponerse en contacto con nosotros. Estaremos encantados de ayudarle. Escríbanos a support@morphic.com.