Register an API

You can register an API with Akamai by entering all details manually or by importing an API definition file that contains information about your API. If you choose to import a file, you still need to enter a few API Gateway-specific parameters to complete the registration process.

Try the API: You can also complete this task by using the API Endpoints API. Run the Create an endpoint operation. Learn more about Akamai’s APIs.

How to

  1. On the API Definitions page, click Register an API.
  2. On the Register new API page, in the API endpoint panel, in the API name field, enter a name for your API.
  3. From the Access control group menu, select the access control group that you want to associate with the API.
    An access control group is a group of users who can view or edit an API.
  4. Optional: If your API uses GraphQL to describe content and deliver it to clients in a structured form, set the GraphQL API switch to Yes.
    This will enable you to configure GraphQL query and body parameters and set GraphQL-specific caching instructions.
  5. Optional: If your API uses API keys for authentication:
    1. In the API key location area, select the location for your API key.
    2. In the location Name field, enter a name for the API key location.
      where location is either Header, Cookie, or Query parameter.
    Akamai uses API keys for user quota and reports.
    Important: If you decide to use API keys for your API configuration, to make productive use of the security benefits that the keys provide, your API consumers should make only secure (HTTPS) requests to your API.

    API key authentication is one of the two protection methods that API Gateway provides. You can also use JSON web tokens to improve security. To optimize the performance of your system, it’s best to implement one protection method per API configuration.

  6. Optional: In the Description field, enter a description for your API.
  7. Optional: In the Categories field, enter or select categories to serve as API filters on the main page.
  8. If your API uses versioning, follow Enter API version details.
  9. Follow one of these steps:
    If...Then...
    If you want to import API endpoint and resource information from an API definition file, then go through API definition file import.
    If you want to enter API endpoint and resource information manually, then do these steps:
    1. Enter API Endpoint details. Follow Enter API endpoint details.
    2. Optional: If you have access to KSD features, set constraints on the API request body and resources. Follow Set API request body and resource constraints.
    3. Add resources to your API endpoint. Follow Add API resources.
  10. Click Save.