- Upload API specifications in OpenAPI or Web Services Description Language (WSDL) format.
- Create a connector project that links a requester organization to a responder organization.
- Map endpoints and fields, with help from AI suggestions or by hand.
- Generate JOLT or XSLT transformations from your approved mappings.
- Design Camel routes in Route Builder from templates, the canvas, or the Route Builder agent.
Workflow at a glance
You build a connector in six stages, in this order:- Upload API specifications. Register each vendor and upload its specifications. Wait until each specification reaches the Indexed status.
- Create a project. Link the requester organization to the responder organization.
- Map endpoints. Match each source API operation to a target operation. AI suggests the matches, and you approve them. You can also map endpoints by hand.
- Map schemas. Match the fields inside each operation. AI suggests the matches, and you review them. You can also map fields by hand.
- Generate transformations. Connector Studio produces JOLT or XSLT files from your approved mappings.
- Design routes. In Route Builder, scaffold routes, start from a template, edit on the canvas or with the agent, then download Java or YAML.
What is Route Builder?
Route Builder is where you design the Camel route for each operation: the path from an inbound API call through the vendor call and transformation to the response. Mapping Workspace covers field mappings. Route Builder covers the runtime flow. For more information, see Design routes with Route Builder. After step 5, download the transformation files from the project. After step 6, export the route design.Rules to follow
- A responder needs at least one Indexed specification before you can create a valid project.
- Map endpoints before you map schemas. Match which API calls align before you match the fields inside them.
- Map schemas only after you approve or receive a suggestion for at least one endpoint pair.
- You can map endpoints and schemas by hand, not only through AI suggestions.