Handlers

Source handlers allow you to define sources that provide data to your mesh. The following table specifies the versions of each handler supported by API Mesh for Adobe Developer App Builder:

Handler Package Name	Version
`openapi`	`0.33.39`
`graphql`	`0.34.13`
`JsonSchema`	`0.35.38`
`soap`	`0.14.25`

The source handlers topic provides more information about handlers in the context of API Mesh.

Whenever a source schema is modified, you must update your mesh to allow API Mesh to cache any changes.

The following example contains a basic mesh file with an OpenAPI source handler.

{
  "meshConfig": {
    "sources": [
      {
        "name": "CommerceREST",
        "handler": {
          "openapi": {
            "source": "your_Commerce_API"
          }
        },
      }
    ]
  },
}
Copied to your clipboard
{
  "meshConfig": {
    "sources": [
      {
        "name": "CommerceREST",
        "handler": {
          "openapi": {
            "source": "your_Commerce_API"
          }
        },
      }
    ]
  },
}

Handlers are located in the sources section of the mesh file. Each source will need a name, a handler, and other key-value pairs that correspond to the handler type. In the previous example, the openapi handler only requires a source.

Reference local files in handlers

To reference files directly, refer to developer tools.

You can reference local files as sources in handlers using the following format:

{
    "meshConfig": {
        "sources": [
            {
                "name": "CommerceREST",
                "handler": {
                    "openapi": {
                        "source": "your_Commerce_API"
                    }
                }
            },
            {
                "name": "CommerceRESTV2",
                "handler": {
                    "openapi": {
                        "source": "./CommerceRestV2.json"
                    }
                }
            }
        ],
        "files": [
            {
                "path": "./CommerceRestV2.json",
                "content": <LOCAL_FILE_CONTENT>
            }
        ]
    }
}
Copied to your clipboard
{
    "meshConfig": {
        "sources": [
            {
                "name": "CommerceREST",
                "handler": {
                    "openapi": {
                        "source": "your_Commerce_API"
                    }
                }
            },
            {
                "name": "CommerceRESTV2",
                "handler": {
                    "openapi": {
                        "source": "./CommerceRestV2.json"
                    }
                }
            }
        ],
        "files": [
            {
                "path": "./CommerceRestV2.json",
                "content": <LOCAL_FILE_CONTENT>
            }
        ]
    }
}