Welcome to BitScoop!
The BitScoop API Toolbox is a set of tools to help developers deal with data provider intricacies, inconsistencies, and annoyances that pervade app development. Using BitScoop you can more easily connect and interact with the data providers important to your work and projects.
The API Toolbox was designed to be as modular as possible to address a wide variety of use cases. But we know your needs as a developer are unique and that we might have missed something important to you. If you notice anything missing or have awesome ideas for how to improve BitScoop, please let us know! We're here to help!
How does this all work?
The BitScoop API Toolbox is built around interacting with "data providers," such as Facebook, Twitter, and Google, and the APIs they provide. The BitScoop API Toolbox makes requests on your behalf to data providers, operates on the data according to any configurations you specify, and transparently relays the results to you. We do our best to normalize irregularities such as authentication, aberrant data formats, token refreshing, etc.
Toward this end, we give you a way to create a few different objects in our system that together establish an easier way to work with your data.
Provider Maps are the JSON configuration objects that you create to describe the interactions with data providers. They can include various sub-sections such as a description of the authentication scheme the data provider uses and endpoints from which you can obtain data.
You can get more information about Maps here.
There are some data providers that require you to obtain permission from your users to access their data (e.g. OpenID and OAuth). We allow you to easily obtain such permission without worrying about how each data provider handles the process. Using the BitScoop API Toolbox you can create "connections" to data providers associated with individual users. We automatically store the necessary information on these connections that you'll need to identify your application and properly request data for individual users.
For more information about Connections check out the documentation here.