Service Limitations

You cannot override the default status code (200) returned from a REST service.

Query and Path Parameters

  • Mixing of path parameters and path parts in a resource URI is not supported. For example, an online bookstore has a service to update (add/delete) the number of books in the inventory based on ISBN. The resource URI of the update operations is:

    http://host:port/store/books/{ISBN}/addToStore/{number-of-books} - where {ISBN} and {number-of-books} are path parameters.

    http://host:port/store/books/{ISBN}/subtractFromStore/{number-of-books}

    Such resource URIs are not supported. However, the current implementation of REST BT supports the resource URI where all the path parameters are suffixed. For example:

    http://host:port/store/books/addToStore/{ISBN}/{number-of-books} - where {ISBN} and {number-of-books} are the path parameters.

  • Usage guidelines for query and path parameters:
    • Path parameters and query parameters must be of Simple type.
    • Query parameters are optional, if not specified.
    • Configuring a custom default value for a query parameter is not supported.
    • The key of the query parameter is the WSDL part name.
    • Path parameters and query parameters must map to a WSDL part. The implementation does not receive query parameters that are not mapped to any WSDL part name.

Request Response

  • REST Request body - There can be at the most one WSDL part referring to a Complex-Type element, which if present is considered as HTTP body.
  • REST Request/Response - The WSDL part representing the REST body, must refer to Element and not the Type. Simple type in body is not supported. However, you can construct a Simple type as Complex-Type Element in a WSDL.