Getting Started Guide for Developing tibbr Apps

Transcription

1 Getting Started Guide for Developing tibbr Apps TABLE OF CONTENTS Understanding the tibbr Marketplace... 2 Integrating Apps With tibbr... 2 Developing Apps for tibbr... 2 First Steps... 3 Tutorial 1: Registering Your App With a Canvas Page... 4 Tutorial 2: Personalizing the User Experience With a Greeting Message... 5 Tutorial 3: Posting on the Wall... 6 Help and Support... 7

2 tibbr is the first enterprise social networking platform, enabling the right information to find the right users. tibbr's unique subject- based approach empowers enterprise users to intelligently consume, filter, and organize information. With tibbr, you can easily share posts, polls, events, documents, and links with your colleagues within public and private subjects. Created for both ease of use and IT manageability with built- in security, governance, and compliance, tibbr also offers native apps for iphone, Android, BlackBerry, and Desktop. You can also integrate your current applications (such as SharePoint, SalesForce, and RSS), add partner applications (such as meetings, document management, ideation, surveys, and gamification), and connect custom apps through our Enterprise Social Graph API. Understanding the tibbr Marketplace In the tibbr Marketplace are apps for enhancing productivity and for leveraging your organization s social enterprise graph. With our developer API, you can build your own apps and integrate them within the tibbr platform, reaching out to the tibbr community of over 1.5 million members. Integrating Apps With tibbr By integrating your apps with tibbr, you add to them a social- collaboration layer across the Web, mobile, and desktop platforms, offering the right context of your apps to users, who can then seamlessly interact with those apps. In addition, thanks to tibbr s event- enabled architecture, your apps scale efficiently, as appropriate. As a strategic partner, we strongly encourage you to integrate your apps with tibbr it s a win- win! Developing Apps for tibbr Before developing apps for tibbr with its app framework, you must be familiar with the following technologies: OAuth 2 Representational state transfer (REST) API calls HTML JavaScript JSON HTTP Requests

3 First Steps The following workflow diagram illustrates the steps for placing your app in the tibbr Marketplace. The tibbr platform supports all common programming platforms and you can build your app in any language or with any Web programming tool, such as PHP, Python, Java, or C#. Before developing your app, contact your tibbr partner- liaison representative, who will assign you a sandbox and send you the related details, including the community login credentials. Note: Be sure to set up your development environment, that is, a hosting space for your App. tibbr does not provide you that space.

4 Tutorial 1: Registering Your App With a Canvas Page To register your app with a Canvas Page: 1. Log in as a developer to the tibbr sandbox. 2. Mouse over Apps in the left panel. tibbr displays a pop- up pane, like this: 3. Click Explore Apps. tibbr displays the following page. 4. Click Register an App. tibbr displays the Basic Info page. 5. Fill in the fields or specify your preferences, as appropriate. Under Application URLs, type the URLs for each of your application s target canvases. Note: tibbr apps are Web apps in the context of tibbr, called a tibbr Canvas Page. See this section for details. For starters, just begin with the home panel and specify the target URL. 6. Click Save. tibbr confirms with a message. Your app is now listed under Company Apps in the tibbr sandbox.

5 Next, enable your app: 1. Mouse over your app icon in Explore Apps and click See Details. tibbr displays a page with the details that pertain to your app. 2. Click Enable. For more details, watch this video, which shows the process of registering and embedding your app into tibbr. You can also download the sample code. Tutorial 2: Personalizing the User Experience With a Greeting Message tibbr offers a rich library of REST APIs for building apps. By extracting parameters through the request URL, such as client key, access token, and display name, you can make API calls to the tibbr server. Once extracted, the user name can serve as a regular string expression for displaying the greeting. Here is an example: String display_name = paramaeter.get( display_name ); Welcome <%= display_name %> For more details, watch the video Parsing User Parameters, which demonstrates the process of parsing user- specific parameters from tibbr. You can also download the sample code. See also the API calls with sample responses.

6 Tutorial 3: Posting on the Wall As an authenticated user, you can post to one or more users or subjects with an API call. Be sure to specify the user or subject names at the beginning of the content string. Otherwise, tibbr sends the post to the authenticated user s public subject. Here s the process: 1. Initiate a user- authenticated session on a tibbr instance. 2. Call with this API with the HTTP method POST: host/a/messages.xml Watch this video for details. For example, to post on the tibbr wall with the LinkedIn app: Request URL: Request XML: <?xml version="1.0" encoding="utf-8"?> <message> <user-id type="integer">5</user-id> <content>hello</content> <parent-id nil="true"></parent-id> </message> Response Header: Cache-Control:private, max-age=0, must-revalidate Connection:keep-alive Content-Encoding:gzip Content-Length:54 Content-Type:text/html;charset=utf-8 Date:Thu, 15 Aug :30:20 GMT Location: TIBBR_API_VERSION:4.1.0 TIBBR_SERVER_VERSION:4.1.0 Vary:Accept-Encoding X-CSRF-Token:XqrtxCzJnVv3FOPnzqf4V7GmM4duEPAp+LzPf11A2+I= X-Runtime:294 JSON Response: {"json_class":"message","id":1470}

7 Help and Support More information and resources are available on the tibbr development portal and in the FAQs. Still have questions? Contact us. A dedicated architect will guide you through the integration process.