niiko/developers

El contrato

Versionado

Cada acción y cada lectura llevan su versión en el contrato, el alcance y la URL. Una versión nueva es un alcance nuevo: las credenciales emitidas para @1 siguen funcionando exactamente como el día que se emitieron.

Última actualización

Dónde vive la versión

En el alcance (crm.call_logged@1), en el docstring del método del SDK, y opcionalmente en la query de la URL (?version=1). Adoptar @2 es una decisión que tomas emitiendo una llave nueva o autorizando de nuevo la aplicación — nunca algo que un install haga por ti.

Cómo se retira una versión

Una versión se anuncia como obsoleta con dos fechas — desde cuándo, y después de cuándo deja de responder — y la ventana nunca es menor de 30 días. Mientras dura, cada respuesta de esa versión lleva una cabecera Sunset. Después, la versión contesta 410 version_retired con las fechas dentro: no un 404, porque un 404 dice «no existe» y te manda a buscar un error de tipeo; un 410 dice «existió, ya no» y te manda a leer el aviso.

Versiones retiradas y obsoletas

Ninguna todavía. Todas las acciones y lecturas están en su primera versión.

Versiones de los paquetes

Los clientes siguen versionado semántico y se regeneran cuando cambia el contrato. Cada versión publicada tiene su propia página con la fecha en que llegó al registro.