doc, provide some examples in README.md

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>
doc, rename API heading to C API

Signed-off-by: Sebastian Freundt <freundt@ga-group.nl>