Instansstrategi
APIer skall finnas i tre instanser:
Sandbox - en mockad testversion som returnerar statiska svar (inga integrationer mot andra applikationer eller system)
Test - en testversion som integrerar mot andra applikationers eller systems testmiljöer
Produktion - produktionsversion som integrerar mot andra applikationers eller systems produktionsmiljöer
Versionshantering
Observera: detta gäller produktionsmiljön.
Ett API skall versionshanteras i två nivåer (exempel: v1.0)
En API-förändring som bryter kontraktet (som gör att APIet inte är bakåtkompatibelt) skall resultera i att man stegar upp huvudversionen (från till exempel v1.0 till v2.0)
En API-förändring som endast lägger till nya resurser eller parametrar till ett API (som gör att APIet är bakåtkompatibelt) skall resultera i att man stegar upp inom huvudversionen (från till exempel v1.0 till v1.1)