Versioning Properties Across Personify APIs

As of 1.5.0, Web Service Designer supports versioning the properties of entities individually against Personify APIs, in addition to entity level versioning. Both entity and property level versioning can be used concurrently.

In order to set the floor API version for a property, drop the entity on the designer canvas and select the appropriate property. In the properties grid, select the appropriate Floor API Version from the drop-down.

For example, “Entity1” with Floor API Version of “7.4.2” and “Property3” with Floor API Version of “7.5.0”.

In the example above, when you build against 7.4.1 APIs, Entity1 will not be available for consumption. When you build against 7.4.2 APIs, Entity1 will be available for consumption, except for Property3. When you build against 7.5.0 APIs, Entity1 will be available for consumption with all the properties, including Property3.

As of 1.8.0, we introduced a new property called CeilingVersion in Data Services for entities and service operations. This indicates up to which version the entity/operation/property will be available in Data Services. If this is left blank, the entity/operation will be available for all API versions.