Learn more:

• Property Manager API

• PAPI Feature Catalog Reference, adaptiveAcceleration behavior.

• Download this API’s RAML and JSON schema descriptors.

Overview

The Adaptive Acceleration product uses Automatic Server Push, with the HTTP/2 protocol, and Automatic Preconnect to increase the speed of page loading. The Adaptive Acceleration API provides the ability to see which rules Adaptive Acceleration applies to a property. It also allows you to start the generation of new rules.

Who should use this API

This API reports how Adaptive Acceleration was applied to a set of web pages. It also allows you to reset the rules when you do a large site update and you want to ensure that Adaptive Acceleration has a policy that is up to date with all of your new resources. These rules are made up of the list of hostnames that Adaptive Acceleration currently preconnects to. They are also made up of the list of resources that Adaptive Acceleration pushes to the browser using server push. There are two different types of rules:

• Default rule: This rule applies to the entire Property Manager property. The default rule shows all the resources pushed and preconnected to for any URL with Adaptive Acceleration enabled that is in the property.

• URL-specific rules: These rules show the additional resources, other than those in the default, that Adaptive Acceleration pushes or preconnects to.

Getting started

Before using the API for the first time:

• Review Get Started with APIs for details on how to set up client tokens to access any Akamai API. These tokens appear as custom hostnames that look like this: https://akzz-XXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXX.luna.akamaiapis.net.

• To enable this API, choose the API service named Adaptive Acceleration, and set the access level to READ-WRITE.

After provisioning the API token, the user associated with the unique token can submit cases on behalf of other users. The property ID is an external dependency for using this API. Get a relevant propertyId value from the List Properties operation in the Property Manager API. You use the same value, but with the prp_ prefix removed. For example, instead of prp_175780, you specify 175780. You can also get this ID in the Property Manager user interface.

Resources

This section provides details on the API’s operations.

API summary

Download the RAML descriptors for this API.

Report on a property

Get a specific property.

{
    "creationDate": "2016-08-25T16:45:02Z",
    "isActive": true,
    "lastModifiedDate": "2016-08-25T16:45:02Z",
    "lastReset": "2016-08-25T16:45:02Z",
    "zoneDeployDate": "2017-01-26T18:07:01Z",
    "version": 123,
    "commonPreconnectHeader": [
        "https://www.example0.com"
    ],
    "commonPushedResources": [
        "https://www.example.com/66dc044c-c886-4eb5-8ff2-d9721ec27fc3.js",
        "https://www.example.com/3e940cc8-8170-4e02-8ba4-5d967a997518.js",
        "https://www.example.com/1f682d27-2afa-4e3a-ac1a-2616629152e7.js",
        "https://www.example.com/12345678-c886-4eb5-8ff2-d9721ec27fc3.js"
    ],
    "pageSpecificRules": [
        {
            "basePageURL": "https://qa.www.example.com/checkout/receipt.jsp",
            "pageSpecificPreconnectHeader": [
                "https://www.example3.com"
            ],
            "pageSpecificPushedResources": [
                "https://qa.www.example.com/css/13455/all.css",
                "https://qa.www.example.com/css/13455/checkout/checkout.css",
                "https://qa.www.example.com/css/13455/checkout/receipt.css",
                "https://qa.www.example.com/js/13455/checkout/checkout.js",
                "https://qa.www.example.com/js/13455/be/ee522b75/scripts/lite-578e4f4264746d53-staging.js",
                "https://qa.www.example.com/js/13455/be/30ea2b75/scripts/lite-554041283961326d-staging.js",
                "https://qa.www.example.com/js/13455/be/b8eeeab7/scripts/lite-561eaa6565363300-staging.js"
            ],
            "basePageURL": "https://www.example.com/30dbc1a6-c9e4-474b-a525-70577c90c62d.html",
            "pageSpecificPreconnectHeader": [
                "https://www.example4.com"
            ],
            "pageSpecificPushedResources": [
                "https://www.example.com/c2be42fc-cc9a-4088-ab1c-1417ac212b6f.css",
                "https://www.example.com/c1ebcb4b-0a1a-4c64-9cc2-59de8ab25995.css",
                "https://www.example.com/34333a06-8e1e-4171-ae19-6560960d24df.css",
                "https://www.example.com/9eea3314-ea4e-4398-8dc7-a049c9706918.css",
                "https://www.example.com/8c8bf80a-dc13-4177-b360-3c7b97aa6d9b.css"
            ]
        }
    ]
}

Reset a property report

After you set up Adaptive Acceleration and view a report for the first time, you can use Reset to purge all the existing information about previous resources pushed and preconnected to and then reset the rules for pushing and preconnecting to resources. If the identity associated with the API token does not have read/write permission within Akamai Control Center, a 403 error results.

Data

This section provides details for each type of data object the API exchanges.

Download the JSON schemas for this API.

The data schema tables below list membership requirements as follows:

PropertyReport

Encapsulates Adaptive Acceleration rules targeted to a specific property.

Download schema: property.json

Sample GET response:

{
    "creationDate": "2016-08-25T16:45:02Z",
    "isActive": true,
    "lastModifiedDate": "2016-08-25T16:45:02Z",
    "lastReset": "2016-08-25T16:45:02Z",
    "zoneDeployDate": "2017-01-26T18:07:01Z",
    "version": 123,
    "commonPreconnectHeader": [
        "https://www.example0.com"
    ],
    "commonPushedResources": [
        "https://www.example.com/66dc044c-c886-4eb5-8ff2-d9721ec27fc3.js",
        "https://www.example.com/3e940cc8-8170-4e02-8ba4-5d967a997518.js",
        "https://www.example.com/1f682d27-2afa-4e3a-ac1a-2616629152e7.js",
        "https://www.example.com/12345678-c886-4eb5-8ff2-d9721ec27fc3.js"
    ],
    "pageSpecificRules": [
        {
            "basePageURL": "https://qa.www.example.com/checkout/receipt.jsp",
            "pageSpecificPreconnectHeader": [
                "https://www.example3.com"
            ],
            "pageSpecificPushedResources": [
                "https://qa.www.example.com/css/13455/all.css",
                "https://qa.www.example.com/css/13455/checkout/checkout.css",
                "https://qa.www.example.com/css/13455/checkout/receipt.css",
                "https://qa.www.example.com/js/13455/checkout/checkout.js",
                "https://qa.www.example.com/js/13455/be/ee522b75/scripts/lite-578e4f4264746d53-staging.js",
                "https://qa.www.example.com/js/13455/be/30ea2b75/scripts/lite-554041283961326d-staging.js",
                "https://qa.www.example.com/js/13455/be/b8eeeab7/scripts/lite-561eaa6565363300-staging.js"
            ],
            "basePageURL": "https://www.example.com/30dbc1a6-c9e4-474b-a525-70577c90c62d.html",
            "pageSpecificPreconnectHeader": [
                "https://www.example4.com"
            ],
            "pageSpecificPushedResources": [
                "https://www.example.com/c2be42fc-cc9a-4088-ab1c-1417ac212b6f.css",
                "https://www.example.com/c1ebcb4b-0a1a-4c64-9cc2-59de8ab25995.css",
                "https://www.example.com/34333a06-8e1e-4171-ae19-6560960d24df.css",
                "https://www.example.com/9eea3314-ea4e-4398-8dc7-a049c9706918.css",
                "https://www.example.com/8c8bf80a-dc13-4177-b360-3c7b97aa6d9b.css"
            ]
        }
    ]
}

PropertyReport members

Errors

This section provides details on the data object that reflects the API’s common response to error cases, and lists the API’s range of response status codes for both error and success cases.

Error responses

The following shows a typical error response. The outer object characterizes the overall problem, while the details array lists potentially more than one problem detected in the request.

{
    "code": "bad.request",
    "details": [
        {
            "code": "bad.request.error",
            "message": "CaseId provided is incorrect"
        }
    ],
    "incidentId": "0c296a9e-b063-44d1-a6c0-35228becc4ab",
    "title": "Bad Request"
}

Error members

Error.details

HTTP status codes

The following lists the range of HTTP response codes the API may produce for both success and error cases:

Last modified: 1/4/2019