Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

When you want to build a simple Blueriq model for your first call to a REST web service (i.e. be the service requestor), you can choose from a wide range of REST service providers. Some providers require you to register first to obtain an API-key that you must include in your request, but there are also API-key-free providers.

Most REST service providers publish documentation, either with an XSD Schema set (just like you use in a SOAP call) or more free-format documentation. They usually include one or more example request and response messages, from which you can (should be able to) derive a Domain schema. In your REST service, you can choose between an XSD schema set of Domain schema. Once you have the required domain, all you need is an exposed flow that contains a page for the user input and the result, and a service call of type AQ_WebServiceClient.

If you want, have a look at the other visual about modeling a web service call from a (more realistic) project with separate implementation modules for the business model and the web service model. In that situation, you will need a data mapping.