@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Hubhopper Partner Integration API(s) - Production
@base https://apis.hubhopper.com/partner
@version v5
@auth ApiKey x-api-key in header | ApiKey hhPartnerId in header
@endpoints 7
@toc categories(3), podcasts(3), util(1)

@group categories
@endpoint GET /categories
@optional {pageSize: any, page: any}
@returns(200)
@errors {404, 500}

@endpoint GET /categories/{categoryId}
@required {categoryId: any}
@returns(200)
@errors {404, 500}

@endpoint GET /categories/{categoryId}/podcasts
@required {categoryId: any}
@optional {page: any, pageSize: any, order: any, filters: any}
@returns(200)
@errors {404, 500}

@endgroup

@group podcasts
@endpoint GET /podcasts
@optional {page: any, pageSize: any, order: any, filters: any}
@returns(200)
@errors {404, 500}

@endpoint GET /podcasts/{podcastId}
@required {podcastId: any}
@returns(200)
@errors {404, 500}

@endpoint GET /podcasts/{podcastId}/episodes
@required {podcastId: any}
@optional {page: any, pageSize: any, order: any, filters: any}
@returns(200)
@errors {404, 500}

@endgroup

@group util
@endpoint GET /util/languages
@optional {pageSize: any, page: any}
@returns(200)
@returns(204)
@errors {401, 404, 500}

@endgroup

@end