support file paths as tika parameter.
improve code comments.
simplify accept header parameter.
fix formatting of service definition json.
add optional ID parameters to main operations.