• Pages
  • /
  • Dealers
  • /
  • Data Depot
  • /
  • Version 4
  • /
  • API
  • /
  • Helpers
  • /
  • Crutches

Crutches

In order to make the transition from Version 3 to Version 4 of the WPS API as painless as possible, we've created a clever concept which we've humorously* dubbed "crutches".
* May not contain actual humor.

Crutches are the bridge from V3 (SKU-based) to V4 (auto-incrementing) identifiers. This feature allows you to "crutch" to the resource using the old V3 identifier, without needing to know the V4 id of the resource.

Obviously this only applies to concepts that existed in V3 and are carried forward into V4. Things like Attributes, Catalogs, Items, Vehicles, etc.

Examples

Items

In the case of the Highway 21 Small Black Gunner Jacket, we can make a request for that specific Item using the V4 id with this request:

http://api.wps-inc.com/items/72728

Conversely, we can "crutch" to the same Item using the V3 identifier with this request:

http://api.wps-inc.com/items/crutch/489-1014S

Attributekeys

In the case of the Color Attributekey, we can make a request for that specific Attributekey using the V4 id with this request:

http://api.wps-inc.com/attributekeys/15

Conversely, we can "crutch" to the same Attributekey using the V3 identifier with this request:

http://api.wps-inc.com/attributekeys/crutch/3