farmet-api: see /docs for the OpenAPI contract