FanFeedr Developer Blog

Roadmap Update

We're excited to report that Team FanFeedr has been busy working on a new version of our API!

So that you can plan accordingly, what follows is a brief preview of what you should expect to see within the next 2 weeks.

A completely RESTful API

Our new API will have the same functionality as the current API, but the routes will change. Programmatically, entity resources will be replaced with UUIDs, as described below.

Methods to retrieve data from the FanFeedr API will require a GET request. The API will support JSON only.

The end result will be clearer organization, more intuitive paths, and reduced datasets.

Available Resources

Each available resource will represent a collection that contains members. Each member will be associated with an UUID, that can be queried to obtain its properties.

Sports resources will be divided into an inheritance structure of:

  • leagues
  • divisions
  • conferences
  • teams
  • persons

In order to obtain information about a specific resource, users must query the ‘parent’ resources.

For example, to get a list of all teams for the NFL, you will need to call /leagues for the relevant nfl_id. A call for /leagues/{nfl_id}/teams returns the team UUIDs. Calls for each team_id return detailed member information such as name, location id, etc.

Other resources include:

  • geo
  • events
  • content
  • images (requires subscription to a paid plan)
  • sources
  • trending

Parent resources are used to pare down what data is returned by these collections.

For example, to get a list of events currently happening for the NBA, you will need to call /leagues/{nba_id}/events/live for event UUIDs. Calls for specific event_id return detailed member information such as home team, away team, location id, scores, etc.

Portal Upgrades

We are taking over management of our developer portal, and no longer will be relying on solutions from our gateway provider. Our goal with the new format will be to foster a sense of community, where developers can easily interact with our API team and help one another with issues encountered.

We will be integrating an interactive Q&A system, API console for testing of various resources, status monitoring tool, and seamless payment solutions.

The documentation will be clear and concise, with examples of calls and responses.

Final Thoughts

If you have any questions or comments on this or any other matter, please contact me directly at benn@fanfeedr.com.

Thank you for being part of the FanFeedr community, and we look forward to continued collaboration.

 

Cheers,

Benn, on behalf of the FanFeedr API Team

2 Comments

  1. tks – 1 year ago

    This sounds great, any idea on a release?

    By the way, sorry for not responding to your e-mail, it's been a rough couple of weeks.

  2. Benn – 1 year ago

    We're just performing some final tests. On schedule to push live by end of next week.

Please sign in to post a comment.