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