Develop > API overview

API overview

You can exercise the Codar RESTful API calls programmatically and from an HTTP client. You can find more information on HTTP clients in Retrieve information from Codar using RESTful calls. Codar also includes a framework for describing, producing, consuming and exercising these RESTful services. In addition to providing reference API documentation, this content provides an interactive environment where you can exercise API calls and view responses from your server.

The following is an example of content for an API call:

Example of content for an API call

You can click on any method listed to get detailed content for that call, and an interactive "Try it out!" feature. The detailed content provides developers quick and easy access the following for each API call:

  • Syntax
  • Method (operation)
  • Parameter descriptions
  • Model and schema information
  • Interactive "Try it out!" dialogs that let you submit calls to your server, see the results, and then understand how you need to construct REST URLs and any payloads.

The following is an example of the detailed content for an API call:

Detail of GET method API

See Retrieve information from Codar using RESTful calls for more information on executing an API call from this interactive content.

Flow of an API call example

The following steps describe an example flow using Codar APIs:

  1. Use the Import an application design API to create an application design by providing the application design in JSON format as input. If the design already exists, an error is returned.
  2. Use the Associate a design to Codar API to tag an application design with the Release Pipeline. This associates a design to the Codar pipeline management process.
  3. Use the Create a package API to create a package for the application design. The package is only created if the Codar license is present and the design is associated to the Release Pipeline.
  4. Once the package is created, use the Deploy a package API. You can also promote or reject packages using the APIs.

The following graphic describes this example flow:

Flow of an API call example