Using Anypoint Platform DataGraph CLI and API Extensions
You can use the Anypoint CLI DataGraph commands to add and edit API sources in DataGraph. To do so, you must first add the appropriate DataGraph API extensions to the API source.
Adding Extensions to Your Project
You must add the extensions to your API-specification project as a dependency and then publish the project to Exchange. After you publish your API-specification project, you can add the API to DataGraph using the CLI.
Use API Designer to add the extensions to your project. Follow the steps in Add Dependencies to an API-Specification Project, choosing Fragments as the dependency type.
API Designer adds the required dependencies to exchange.json and validates the syntax of any annotations you added before publishing your project to Exchange.
Maintaining RAML Compatibility
To maintain compatibility in RAML specifications with tools that do not support API extensions, these extensions include a “RAML companion” that provides a simple version of RAML annotations definition. To use DataGraph API extensions in RAML, add the following code to the main file of the API-project specification:
uses: dg: exchange_modules/<group>/<asset>/<version>/datagraph-api-extensions.raml
You can change the prefix dg if needed, but it must match the prefix used in the extensions.
The <group>, <asset>, and <version> reference the API extensions that are published in Exchange.