@lap v0.3
# Machine-readable API spec. Each @endpoint block is one API call.
@api Flickr API Schema
@base https://api.flickr.com/services
@version 1.0.0
@auth ApiKey api_key in query
@endpoints 25
@hint download_for_search
@toc rest?method=flickr.favorites.getList(1), rest?method=flickr.people.getPhotos(1), rest?method=flickr.photosets.getList(1), rest?method=flickr.favorites.getContext(1), rest?method=flickr.groups.getInfo(1), rest?method=flickr.groups.pools.getPhotos(1), rest?method=flickr.groups.discuss.topics.getList(1), rest?method=flickr.groups.discuss.replies.getInfo(1), rest?method=flickr.groups.discuss.topics.getInfo(1), rest?method=flickr.groups.pools.getContext(1), rest?method=flickr.photolist.getContext(1), rest?method=flickr.photos.getContext(1), rest?method=flickr.photos.licenses.getInfo(1), rest?method=flickr.people.getInfo(1), rest?method=flickr.photos.getExif(1), rest?method=flickr.photos.getInfo(1), rest?method=flickr.photos.getSizes(1), rest?method=flickr.photosets.getContext(1), rest?method=flickr.photosets.getPhotos(1), rest?method=flickr.galleries.getPhotos(1), rest?method=flickr.photos.search(1), upload(1), rest?method=flickr.test.echo(1), oauth(2)

@group rest?method=flickr.favorites.getList
@endpoint GET /rest?method=flickr.favorites.getList
@required {api_key: any, user_id: any}
@optional {min_fave_date: any, max_fave_date: any, page: any, per_page: any}
@returns(200)

@endgroup

@group rest?method=flickr.people.getPhotos
@endpoint GET /rest?method=flickr.people.getPhotos
@required {api_key: any, user_id: any}
@optional {safe_search: any, min_upload_date: any, max_upload_date: any, min_taken_date: any, max_taken_date: any, content_type: any, privacy_filter: any, page: any, per_page: any}
@returns(200)

@endgroup

@group rest?method=flickr.photosets.getList
@endpoint GET /rest?method=flickr.photosets.getList
@required {api_key: any, user_id: any}
@optional {page: any, per_page: any}
@returns(200)

@endgroup

@group rest?method=flickr.favorites.getContext
@endpoint GET /rest?method=flickr.favorites.getContext
@required {api_key: any, photo_id: any}
@optional {user_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.getInfo
@endpoint GET /rest?method=flickr.groups.getInfo
@required {api_key: any}
@optional {group_id: any, group_path_alias: any, lang: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.pools.getPhotos
@endpoint GET /rest?method=flickr.groups.pools.getPhotos
@required {api_key: any}
@optional {group_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.discuss.topics.getList
@endpoint GET /rest?method=flickr.groups.discuss.topics.getList
@required {api_key: any}
@optional {group_id: any, page: any, per_page: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.discuss.replies.getInfo
@endpoint GET /rest?method=flickr.groups.discuss.replies.getInfo
@required {api_key: any, topic_id: any, reply_id: any}
@optional {group_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.discuss.topics.getInfo
@endpoint GET /rest?method=flickr.groups.discuss.topics.getInfo
@required {api_key: any, topic_id: any}
@optional {group_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.groups.pools.getContext
@endpoint GET /rest?method=flickr.groups.pools.getContext
@required {api_key: any, photo_id: any}
@optional {group_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photolist.getContext
@endpoint GET /rest?method=flickr.photolist.getContext
@required {api_key: any, photo_id: any, photolist_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.getContext
@endpoint GET /rest?method=flickr.photos.getContext
@required {api_key: any, photo_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.licenses.getInfo
@endpoint GET /rest?method=flickr.photos.licenses.getInfo
@required {api_key: any}
@returns(200)

@endgroup

@group rest?method=flickr.people.getInfo
@endpoint GET /rest?method=flickr.people.getInfo
@required {api_key: any}
@optional {user_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.getExif
@endpoint GET /rest?method=flickr.photos.getExif
@required {api_key: any, photo_id: any}
@optional {secret: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.getInfo
@endpoint GET /rest?method=flickr.photos.getInfo
@required {api_key: any, photo_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.getSizes
@endpoint GET /rest?method=flickr.photos.getSizes
@required {api_key: any, photo_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photosets.getContext
@endpoint GET /rest?method=flickr.photosets.getContext
@required {api_key: any, photo_id: any}
@optional {photoset_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photosets.getPhotos
@endpoint GET /rest?method=flickr.photosets.getPhotos
@required {api_key: any, photoset_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.galleries.getPhotos
@endpoint GET /rest?method=flickr.galleries.getPhotos
@required {api_key: any, gallery_id: any}
@returns(200)

@endgroup

@group rest?method=flickr.photos.search
@endpoint GET /rest?method=flickr.photos.search
@required {api_key: any}
@optional {text: any, tags: any, user_id: any, min_upload_date: any, max_upload_date: any, min_taken_date: any, max_taken_date: any, license: any, sort: any, privacy_filter: any, bbox: any, accuracy: any, safe_search: any, content_type: any, machine_tags: any, machine_tag_mode: any, group_id: any, contacts: any, woe_id: any, place_id: any, media: any, has_geo: any, geo_context: any, lat: any, lon: any, radius: any, radius_units: any, is_commons: any, in_gallery: any, is_getty: any, per_page: any, page: any}
@returns(200)

@endgroup

@group upload
@endpoint POST /upload
@required {api_key: any, photo: any}
@optional {title: any, description: any, tags: any, is_public: any, is_friend: any, is_family: any, safety_level: any, content_type: any, hidden: any}
@returns(200)

@endgroup

@group rest?method=flickr.test.echo
@endpoint GET /rest?method=flickr.test.echo
@required {api_key: any}
@optional {echo: any}
@returns(200)

@endgroup

@group oauth
@endpoint GET /oauth/request_token
@required {oauth_consumer_key: any, oauth_nonce: any, oauth_timestamp: any, oauth_signature_method: any, oauth_version: any, oauth_signature: any, oauth_callback: any}
@returns(200)

@endpoint GET /oauth/access_token
@required {oauth_consumer_key: any, oauth_nonce: any, oauth_timestamp: any, oauth_signature_method: any, oauth_version: any, oauth_signature: any, oauth_verifier: any, oauth_token: any}
@returns(200)

@endgroup

@end