Archive by Author

API Improvements: Bearer Tokens & Project Admin

Today we have launched some improvements to the API to allow you to more easily have programmatic access to your project data.  Bearer tokens are an extension to the existing OAuth negotiation that makes it vastly easier for your program to access the API.  Additionally, the API can now be used with the project data export launched in September to easily make regular backups of your project’s data, as well as now being able to install new tools for a project programmatically.

Bearer Tokens

token

On the OAuth tab under your Account settings, you can now generate a bearer token for any registered OAuth application.  These tokens are pre-negotiated, so your application doesn’t need to deal with the multi-step OAuth verification process and can just include the token in the access_token parameter to any HTTPS GET or POST request to the API.  Note: because these tokens grant all of the access rights of your account, you should protect them carefully and revoke any that you are no longer using.  More information on using bearer tokens, including example code, is available on the wiki.

Project Admin API

The project data export feature can now be accessed via the API, so you can schedule a project export, check the export’s status, and download the exported data, all programmatically.  There is even a drop-in script ready to do all of these steps for you.

Additionally, you can now install new tools, such as new repositories or ticket trackers, into your project via the API.  More information is available on the wiki.

New Download Statistics Breakdown

Developers love statistics about their project and how it’s doing, and so, one of the features we provide for our projects are download statistics. This allows a project admin to get an idea of how actively their project is being downloaded, where from, and for what operating system.

In June, in addition to tracking total downloads by country and total downloads by operating system, we also began tracking how many downloads per OS there were for each country. This information is now available on the interactive Download Statistics page.

 

You can view the results either as a total count of OS downloads per country, or as the OS’s percentage of that country’s downloads. The table is of course sortable in both views by any column, and the interactive map is presented to give a visual representation of which are your most active regions.

You can see these statistics by clicking the Downloads Count link on your project’s Summary page.

So, how would you leverage these statistics to give your users the best experience with your software project?