add examples for api (especially for mandatory output parameters)

[j-a-dietrich]

I think it would be great to have some examples for the api also because our target group should be developers who implement this format in their tools and then add the mandatory and optional output parameters according to their step in the pipeline.