Nav

API Specification for MuleSoft Connectivity Ecosystem

If you are an independent software vendor (ISV), you can participate in the MuleSoft Connectivity Ecosystem by auto-generating a connector from a REST API specification. These steps explain how to prepare your API specification in Anypoint Platform and how to work with your Mulesoft BD counterpart to do the rest.

  1. In Anypoint Platform, follow these steps to prepare your API specification:

    1. Sign up for Anypoint Platform:

    2. Log into Anypoint Platform and click Design Center.

    3. Create a new API specification project by clicking +Create in the top-right corner and selecting API Specification.

    4. In the New API Specification dialog, specify a name for your project, select Start with API Designer, and click Create.

    5. On the left side of the screen, click the action menu (the three-dot icon) at the top of the file list and select Import.

      • If you want to import a RAML file, select File or ZIP or URL.

      • If you want to import a Swagger/OAS file, select OAS File or ZIP or OAS URL.

      API Designer converts Swagger/OAS files to RAML. If any errors are reported during the conversion, address them by following the instructions in the error messages.

    6. After importing, test your API to make sure it works as you expect it to.

      1. In the top-right corner of the screen, switch on the mocking service.

      2. In the file list, select your API specification.

      3. In the API summary on the right side of the screen, expand the Resources entry until you see the methods for your resources.

      4. Click one of the methods.

      5. Review the information about the method.

      6. Click Try It.

      7. If the endpoint requires parameters, specify values for them.

      8. Click Send.

    The results of the test of the method appear on the right side of the screen under the Send button.

  2. After your API specification is ready, save it in a git-compatible repository, such as GitHub or Bitbucket.

  3. Contact your Mulesoft BD counterpart and follow these steps:

    1. Sign the Technology Partner Agreement (provided by your MuleSoft BD counterpart)

    2. Ask for an extension to the expiration date of your trial of Anypoint Platform.

    3. Ask for an invitation to the Connectivity Assets Manager tool, a self-service certification tool for connectivity assets, and create a new Anypoint Platform account based on the invitation.

    4. Schedule a short demonstration to help MuleSoft understand your APIs and how they work in the Anypoint Platform.