Over the last weekend the Q4/2011 release of SAP StreamWork was deployed to the production instance. For developers this release brings some changes:
- Enhanced navigation in StreamWork Developer section
- Deprecation of 2-legged OAuth REST endpoints
- Completion of OpenSocial API/Deprecation of Method API
Enhanced navigation in StreamWork Developer section
First of all the developer documentation got changed. On the left you will find a navigation tree which makes it a lot easier to browse the documentation. Go check it out at
http://streamwork.com/developers.
Deprecation of 2-legged Oauth REST endpoints
The second change which I would like to highlight is the fact that the 2-legged OAuth endpoints for the Feed API got deprecated. These changes were made to provide better auditing capabilities. With this change it is possible track down each call to a specific user. It is no longer possible to do an anonymous call to create topics etc.
Below you will find a table that provides the mapping between old and new API calls:
Description | Old API | New API |
---|
Create a topic for the specified organization | POST /v1/org_feed/{org_id}/topics | POST /v1/feed/org/{org_id}/topics |
Create an app-level topic | POST /v1/app_feed/topics | POST /v1/feed/topics |
Delete a topic | DELETE /v1/app_feed/topics/{topic_id} | DELETE /v1/feed/topics/{id} |
Set a user as following the specified topic | POST /v1/user_feed/{user_id}/follows/{topic_id} | POST /v1/feed/topics/{id}/followers/{user_id} |
Unset a user as following the specified topic | DELETE /v1/user_feed/{user_id}/follows/{topic_id} | DELETE /v1/feed/topics/{id}/followers/{user_id} |
Grant a user access to the feed for a specified topic | POST /v1/app_feed/topics/{topic_id}/access_grants/{user_id} | POST /v1/feed/topics/{topic_id}/access_grants/{user_id} |
Revoke user access to the feed for a specified topic | DELETE /v1/app_feed/topics/{topic_id}/access_grants/{user_id} | DELETE /v1/feed/topics/{topic_id}/access_grants/{user_id} |
Grant a user access to the feed for a specified topic | POST /v1/app_feed/topics/access_grants | POST /v1/feed/topics/access_grants |
Revoke user access to the feed for a specified topic | DELETE /v1/app_feed/topics/access_grants | DELETE /v1/feed/topics/access_grants |
Completion of OpenSocial API/Deprecation of Method API
With the Q4/2012 deployment OpenSocial support got completed. It is now possible to create OpenSocial gadgets in an activity via the REST API. The data of an OpenSocial gadget can now also be read & updated via the REST API. StreamWork now also provides functionality for broadcasting PBE updates, so that updates to a gadget that are submitted on one client are displayed on other clients displaying the same gadget, without requiring page refreshes. PBE (presence based editing) support is enabled via an OpenSocial extension (<REQUIRE FEATURE="StreamWork.PBE"/>).
As a result of completing OpenSocial support the StreamWork Method API was deprecated.