Getting started with Developer API

Gemfury API is a REST API over HTTPS primarily using JSON for payload encoding. Every request includes a method, a path, and some headers. Operations are carried out via GET, POST, PATCH, PUT, and DELETE methods. Parameters to the API are specified via the URL query parameters or sometimes the JSON payload, based on the functionality of a specific endpoint.

Base URL

All API requests are made to the following base URL:

https://api.fury.io

Authentication

All API requests require authentication with an API token. You can obtain your API token from your Gemfury dashboard. Then, include your API token in the Authorization header of your requests:

Authorization: Bearer YOUR_API_TOKEN

Account Context & Impersonation

API tokens are generated for a specific account; by default, all API requests with that token operate within the context of that account. You can override this default by explicitly specifying the account username using the as URL parameter:

GET https://api.fury.io/1/packages?as=ACCOUNT

Do not confuse the context account with the token owner (or assignee). The token assignee will be attributed as the actor of account actions performed with the token.

API Versioning

The Gemfury API is versioned to allow builders to roll out changes over time. We ensure that any changes to a specific version of the API are backward compatible. Any breaking changes will only be released in a new API version.

The current version of the API is 1.

The API version can be specified via either a path prefix:

https://api.fury.io/1

Or by using the X-Fury-Api-Version header:

X-Fury-Api-Version: 1

Next