Application Programming Interface (API)

      Last updated May 15, 2020

    The Fastly Application Programming Interface (API) allows you to integrate your applications and services with the Fastly platform.

    Our API is presented using a REST model. It uses standard HTTP response codes and verbs to allow you to programmatically control all the same features that are available through the Fastly web interface. Our web interface is a client of our public API.

    Documentation

    The Fastly API provides a variety of endpoints that we document in our API reference documentation. The endpoint documentation for each API call shows the method, path, authentication type, resource, and parameters that must be combined with the base URL to form a request.

    Client libraries

    To make coding against the Fastly API easier, we maintain a list of client libraries in a variety of languages. Our client list provides more information about each of the client libraries in our list, including third-party tools and integrations in other languages created by the Fastly community.

    Base URL and endpoints

    With one exception, all API calls referenced in our documentation start with a base URL:

    https://api.fastly.com/

    The base URL for the real-time analytics API is:

    https://rt.fastly.com

    Authentication

    Nearly all API requests require authentication using an API token. You can limit the capabilities of those tokens using a scope. Our authentication page provides more information about the API tokens you must use to authenticate. Our guide to Using API tokens provides more information about managing these tokens via the web interface depending on the role your organization has assigned to your account.

    Errors

    Fastly uses standardized HTTP response codes to indicate the success or failure of an API request. Codes in the 2xx range indicate success and confirm a request worked as expected. Codes in the 4xx range indicate an error and provide both an error code and a brief explanation.

    Rate limiting

    Unless otherwise stated in the API reference documentation for individual endpoints, API access is limited to 1,000 non-read requests per hour, per user account. If more than one API token is associated with one user, all that user's tokens share the same limit. Information about rate limit consumption and remaining credit is available in an HTTP response header, examples of which can also be found in our API reference documentation.

    TLS version requirement

    The Fastly API requires TLS 1.2. Because of the PCI Security Standards Council mandate, TLS versions 1.0 and 1.1 are no longer supported for accessing Fastly's API.

    Back to Top

    Additional resources: