Collaboration

Discuss Apps and APIs, write reviews, and manage app development cycle issues.

Table of Contents

  1. How do I collaborate in the platform?
  2. What are the differences between the App and API Boards?
  3. What information is displayed on each Board?
  4. Where can I find rating and review information for each API?
  5. How do I rate an API?
  6. How do I review an API?

How do I collaborate in the platform?

The platform includes an API Board and App Board that can be used to promote APIs and Apps, manage issues associated with the development cycle, or enhance the visibility of topics relating to a specific app or API.

App/API Board

Each app and API has its own Board that includes both a topic board and a ticket management system.

Back to top

What are the differences between the App and API Boards?

At the app level (My Apps > App Board), collaboration is made possible by inviting individuals to join your application development team. Team members can then create private discussions with other team members pertaining to an app and the APIs it is consuming, and can create tickets pertaining to issues associated with app development.

At the API level (My Apps > Board), API developers and app team members can post discussions pertaining to a specific API, or create tickets pertaining to issues associated with API operation.

For more information about the App Board, see App Board.

For more information about the API Board, see API Board.

Back to top

What information is displayed on each Board?

The following table illustrates the relationship of each newsfeed type to each Board, and shows the newsfeed types that display in the Dashboard.

Discussion Ticket Alert API Access Request App Team Membership Requests
API Board
X
X
X
X
--
App Board
X
X
X
X
X
Dashboard
X
X
X
X
X

Back to top

Where can I find rating and review information for each API?

Each API can include rating and review information from platform community members. The information is available on the API Details page as follows:

Back to top

How do I rate an API?

You can rate an API on the API Details page as follows:

To rate an API:
  1. Navigate to the API Details page for the API you would like to rate.
  2. In the Peer Rating section, go to Rate this API and click the star that represents the level of positive feedback you would like to submit for the current API. The rating counter increments by one next to the star rating you selected and the star rating turns red.

You can change your rating at any time by selecting another star.

Back to top

How do I review an API?

You can write a review for an API on the API Details page as follows:

To write a review for an API:
  1. Navigate to the API Details page for the API you would like to review.
  2. Go to the Write a Review section.
  3. Enter a title for the review.
  4. Enter the review contents.
  5. Click Save. Your review is posted.
  6. Community members can now read your review and rate it to indicate whether it was helpful.

Note: If someone comments on your review, you receive a notification email.

Back to top