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.
- Path parameters and query parameters must be of
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 an HTTP body. - REST Request/Response - The WSDL part representing the REST body, must refer to
Element
and not theType
.Simple
type in the body is not supported. However, you can construct aSimple
type asComplex-Type
Element
in a WSDL.