Using the Product Catalog Developer Portal
The API developer portal serves as a central hub for developers who want to learn about, access, and use the Product Catalog APIs. The content on the developer portal helps developers build their organization’s systems and ensures a smooth transition to using the Product Catalog APIs.
Developer Portal Capabilities
The developer portal offers the following capabilities:
- A glossary of terms, along with definitions and examples of key Product Catalog concepts, such as products, bundles, and rule sets
- List of API prerequisites and authentication requirements, success and error codes, and limitations. Code samples are included
- Details of each API, including their respective endpoints, methods, paths, and fields
- Form to request access to Production APIs
- An API “mock” service that allows you to submit realistic, pre-defined API requests and observe the expected responses
Access to Production APIs
The following production APIs are now available:
- Intake API
Each airline or their authorized technology providers can create and maintain Product Catalog data. - Subscription API
Access your own or authorized partner catalogs.
Who Should Request Access to Production APIs
Airlines and technology providers that are ready to actively engage in API implementation should request access to this first release. Request access now if your team is planning to begin integration work, support a pilot airline, or participate in a Proof of Concept (POC), such as launching and distributing a new product or creating ancillary bundles with traditional or dynamic content, or both. Access requires completing an onboarding process to ensure readiness for implementation. Once you request access, ATPCO will contact you.
If you're not ready to integrate yet, you can still start exploring the API documentation and test endpoints using sample data here in our Development Portal.
Scope of production APIs
Some data and capabilities are out of scope for the initial MVP implementation and are planned to be delivered later. More APIs, such as channel and aggregator-facing APIs (Airline Profile) are still in development in collaboration with ATPCO’s working groups and will also be released in a future phase.
API Mock Service
The mock service environment enables you to try out the Product Catalog Intake and Subscription APIs using the OpenAPI 3.0 format. The mock service offers an assortment of scenarios that represent actual design contracts and is not connected to a live backend system. This controlled environment enables you to experiment with a range of simulated inputs and outputs so that you can understand the behavior of the APIs in various scenarios and still avoid the risks associated with using production data.
ATPCO invites you to share your experiences using the APIs in the mock service. For example, if you want to investigate an use case that is not provided or if you foresee challenges with integrating to the APIs, we welcome the opportunity to meet and discuss your situation to determine how we can assist you in meeting your goals for using the APIs.
Developer Portal Site Navigation
Here are some suggestions for navigating the developer portal site.
Mock Service Navigation Bar
The following navigation bar is positioned across the top of the mock service pages of the site.
Here are instructions for using the navigation bar elements.
On the navigation bar, click Routing: Proxy. When accessing the mock service, be sure to use the Routing requests via secure proxy setting.
On the navigation bar, use the radio button to select either Elements or SwaggerUI.
- The Elements setting provides a granular view of each request and response field in the selected message type.
- The SwaggerUI setting provides a comprehensive view of all the message types and enables you to send requests and view expected responses in the mock environment.
📝 For the optimal experience when sending Subscription API requests in the mock environment, use the Swagger UI setting.
Please ignore the Open in Explore option.
Please ignore the Generate Code option.