We don’t have good documentation at the moment for using mappings in a device handler specificaly. You can find some information about configuring the mappings to handle inbound requests in the SmartApp Web Services guide. There’s also an example SmartApp that exposes web APIs [here][2].
We do have in our backlog work to document web services better overall, including in device handlers.