REST Web Services

REST (Representational State Transfer) Web services are one way of providing interoperability between computer systems on the Internet.

Details can be found here:

• Wikipedia
• InfoQ

All requests are sent to the base URL. The URL differs according to the access control you choose.

• Basic-URL (IP Whitelist): https://wsportal-tst.dsb.net
• Basic-URL (Client Certificate): https://wsportal-cca-tst.dsb.net

• Basic-URL(IP Whitelist): https://wsportal-prd.dsb.net
• Basic-URL (Client Certificate): https://wsportal-cca.dsb.net

The ccb-connect web services require BASIC Authentication.

Access is granted to methods and clients. Ask your customer contact to get access.

In principle, if no HTTP code 200 is returned, always check for an existing error response.
Depending on where the error is detected or thrown in the program flow, it is not always possible to return a consistent response for all possible errors. Sample.:

{
'status':500,
'code':500,
'message':'An unknown error occurred. No further information available.',
'developerMessage':'...',
'moreInfoUrl':'mailto:bibo@dsb-ccb.net'
}

Apart from this error structure, it can happen in rare cases that a somewhat different error response returns.

{
    "validationErrors": {
        "HttpMessageNotReadableException": "Required request body is missing: public java.lang.String net.dsb.ws.rest.subscription.SubscriptionController.changePayment(java.lang.String,java.lang.String,java.lang.String,java.lang.String,java.lang.Boolean,java.lang.String,javax.servlet.http.HttpServletResponse) throws java.lang.Exception"
    }
}