We continue to add features and improve the developer experience for the Property Manager API (PAPI), and here are the recent key improvements you should be aware of:
Improved Search – The search endpoint now includes properties that have not yet been activated. Search allows you to retrieve a particular property (by property name, hostnames and edge hostnames) without traversing the entire group hierarchy.
Activation Control – For better control around activations, PAPI now supports fast fallback and early validation. Furthermore, fast activation (~2 minutes on staging and ~10 minutes on production) has recently been made available to all customers, and is the default for all config changes unless you're adding or removing hostnames.
Custom Behaviors – The ability to reuse advanced metadata via PAPI is included. Stay tuned for the upcoming official release of Custom Behaviors for Property Manager and PAPI (coming shortly).
Validate Only Option - You can now submit a new config rule tree for validation without creating a new property version.
Optional Resource Prefixes - Resource prefixes (prp_1234, ctr_5678 etc) are now optional, making it easier to build applications across PAPI and other Open APIs.
Optional groupId and contractId - groupId and contractId query parameters are now optional for most PAPI endpoints.
A reminder on Rule formats: Rule format v2017-06-19 was released a few months ago and has the most up-to-date list of Property Manager features. If you are not already using a fixed rule format, you should do so to prevent Akamai feature changes from breaking your code. See the PAPI documentation on how to "Freeze a Rule Tree’s Feature Set" for more details https://developer.akamai.com/api/luna/papi/resources.html. We intend to release a new rule format roughly every six months.
All these improvements are fully backward-compatible, so the PAPI version number stays on v1.
Jay Sikkeland is a senior product manager at Akamai Technologies.