{ "swagger": "2.0", "info": { "title": "Flickr API Schema", "description": "A subset of Flickr's API defined in Swagger format.", "termsOfService": "https://www.flickr.com/services/api/tos/", "version": "1.0.0" }, "basePath": "/services", "host": "api.flickr.com", "schemes": [ "https" ], "consumes": [ "multipart/form-data" ], "produces": [ "application/json" ], "paths": { "/rest?method=flickr.favorites.getList": { "get": { "operationId": "getFavoritesByPersonID", "description": "Returns a list of the user's favorite photos. Only photos which the calling user has permission to see are returned.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "required": true, "type": "string" }, { "name": "min_fave_date", "in": "query", "type": "number" }, { "name": "max_fave_date", "in": "query", "type": "number" }, { "name": "page", "in": "query", "type": "number" }, { "name": "per_page", "in": "query", "type": "number" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "page": { "type": "number" }, "pages": { "type": "number" }, "perpage": { "type": "number" }, "total": { "type": "number" }, "photos": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/rest?method=flickr.people.getPhotos": { "get": { "operationId": "getMediaByPersonID", "description": "Return photos from the given user's photostream", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "required": true, "type": "string" }, { "name": "safe_search", "in": "query", "type": "number" }, { "name": "min_upload_date", "in": "query", "type": "number" }, { "name": "max_upload_date", "in": "query", "type": "number" }, { "name": "min_taken_date", "in": "query", "type": "number" }, { "name": "max_taken_date", "in": "query", "type": "number" }, { "name": "content_type", "in": "query", "type": "number" }, { "name": "privacy_filter", "in": "query", "type": "number" }, { "name": "page", "in": "query", "type": "number" }, { "name": "per_page", "in": "query", "type": "number" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "page": { "type": "number" }, "pages": { "type": "number" }, "perpage": { "type": "number" }, "total": { "type": "number" }, "photos": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/rest?method=flickr.photosets.getList": { "get": { "operationId": "getAlbumsByPersonID", "description": "Returns the albums belonging to the specified user", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "required": true, "type": "string" }, { "name": "page", "in": "query", "type": "number" }, { "name": "per_page", "in": "query", "type": "number" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "page": { "type": "number" }, "pages": { "type": "number" }, "perpage": { "type": "number" }, "total": { "type": "number" }, "photosets": { "type": "array", "items": { "$ref": "#/definitions/Album" } } } } } } } }, "/rest?method=flickr.favorites.getContext": { "get": { "operationId": "getFavoritesContextByID", "description": "Returns next and previous favorites for a photo in a user's favorites", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "user_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "prevphoto": { "$ref": "#/definitions/ContextPhoto" }, "nextphoto": { "$ref": "#/definitions/ContextPhoto" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.groups.getInfo": { "get": { "operationId": "getGroupByID", "description": "Get information about a group", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" }, { "name": "group_path_alias", "in": "query", "required": false, "type": "string" }, { "name": "lang", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "group": { "$ref": "#/definitions/Group" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.groups.pools.getPhotos": { "get": { "operationId": "getGroupPhotosByID", "description": "Returns a list of pool photos for a given group", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "photos": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/rest?method=flickr.groups.discuss.topics.getList": { "get": { "operationId": "getGroupDiscussionsByID", "description": "Get a list of discussion topics in a group.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" }, { "name": "page", "in": "query", "type": "number" }, { "name": "per_page", "in": "query", "type": "number" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "iconserver": { "type": "number" }, "iconfarm": { "type": "number" }, "name": { "type": "string" }, "members": { "type": "number" }, "privacy": { "type": "number" }, "lang": { "type": "string" }, "ispoolmoderated": { "type": "boolean" }, "total": { "type": "number" }, "page": { "type": "number" }, "per_page": { "type": "number" }, "pages": { "type": "number" }, "topics": { "type": "array", "items": { "$ref": "#/definitions/Topic" } } } } } } } }, "/rest?method=flickr.groups.discuss.replies.getInfo": { "get": { "operationId": "getGroupTopicRepliesByID", "description": "Get information on a group topic reply", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" }, { "name": "topic_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "reply_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "reply": { "$ref": "#/definitions/TopicReply" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.groups.discuss.topics.getInfo": { "get": { "operationId": "getGroupTopicByID", "description": "Get information about a group discussion topic", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" }, { "name": "topic_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "topic": { "$ref": "#/definitions/Topic" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.groups.pools.getContext": { "get": { "operationId": "getGroupPhotosByID", "description": "Returns next and previous photos for a photo in a group pool", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "group_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "prevphoto": { "$ref": "#/definitions/ContextPhoto" }, "nextphoto": { "$ref": "#/definitions/ContextPhoto" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photolist.getContext": { "get": { "operationId": "getPhotolistContextByID", "description": "Returns next and previous photos in a photo list", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "photolist_id", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "prevphoto": { "$ref": "#/definitions/ContextPhoto" }, "nextphoto": { "$ref": "#/definitions/ContextPhoto" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photos.getContext": { "get": { "operationId": "getPhotostreamContextByID", "description": "Returns next and previous photos for a photo in a photostream", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "prevphoto": { "$ref": "#/definitions/ContextPhoto" }, "nextphoto": { "$ref": "#/definitions/ContextPhoto" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photos.licenses.getInfo": { "get": { "operationId": "getLicenseByID", "description": "Fetches a list of available photo licenses for Flickr", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "licenses": { "type": "object", "properties": { "license": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "integer" }, "name": { "type": "string" }, "url": { "type": "string" } } } } } }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.people.getInfo": { "get": { "operationId": "getPersonByID", "description": "Returns a person", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "user_id", "in": "query", "required": false, "type": "string", "pattern": "^([0-9]+@N[0-9]+)|([0-9a-zA-Z-_]+)$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "person": { "$ref": "#/definitions/Person" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photos.getExif": { "get": { "operationId": "getPhotoExifByID", "description": "Retrieves a list of EXIF/TIFF/GPS tags for a given photo. The calling user must have permission to view the photo.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "secret", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "photo": { "type": "object", "properties": { "id": { "type": "string" }, "secret": { "type": "string" }, "server": { "type": "string" }, "farm": { "type": "string" }, "camera": { "type": "string" }, "exif": { "type": "array", "items": { "type": "object", "properties": { "tagspace": { "type": "string" }, "tagspaceid": { "type": "string" }, "tag": { "type": "string" }, "label": { "type": "string" }, "raw": { "type": "object", "properties": { "_content": { "type": "string" } } } } } } } }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photos.getInfo": { "get": { "operationId": "getPhotoByID", "description": "Returns a photo", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "a photo", "schema": { "type": "object", "properties": { "photo": { "$ref": "#/definitions/Photo" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photos.getSizes": { "get": { "operationId": "getPhotoSizesByID", "description": "Returns photo sizes", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "Photo sizes", "schema": { "type": "object", "properties": { "sizes": { "type": "object", "properties": { "canblog": { "type": "number" }, "canprint": { "type": "number" }, "candownload": { "type": "number" }, "sizes": { "type": "array", "items": { "$ref": "#/definitions/Size" } } } }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photosets.getContext": { "get": { "operationId": "getAlbumContextByID", "description": "Returns next and previous photos for a photo in a set", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photo_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "photoset_id", "in": "query", "required": false, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "prevphoto": { "$ref": "#/definitions/ContextPhoto" }, "nextphoto": { "$ref": "#/definitions/ContextPhoto" }, "stat": { "$ref": "#/definitions/Stat" } } } } } } }, "/rest?method=flickr.photosets.getPhotos": { "get": { "operationId": "getAlbumByID", "description": "Returns a list of photos in an album.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "photoset_id", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "photoset": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/rest?method=flickr.galleries.getPhotos": { "get": { "operationId": "getGalleryPhotosByID", "description": "Returns a list of photos in a gallery.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "gallery_id", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "photos": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/rest?method=flickr.photos.search": { "get": { "operationId": "getMediaBySearch", "description": "Return a list of photos matching some criteria.", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "text", "description": "A free text search. Photos who's title, description or tags contain the text will be returned. You can exclude results that match a term by prepending it with a - character.", "in": "query", "type": "string" }, { "name": "tags", "description": "A comma-delimited list of tags. Photos with one or more of the tags listed will be returned. You can exclude results that match a term by prepending it with a - character.", "in": "query", "type": "string" }, { "name": "user_id", "description": "The NSID of the user who's photo to search. If this parameter isn't passed then everybody's public photos will be searched. A value of \"me\" will search against the calling user's photos for authenticated calls.", "in": "query", "type": "string" }, { "name": "min_upload_date", "description": "Minimum upload date. Photos with an upload date greater than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.", "in": "query", "type": "string" }, { "name": "max_upload_date", "description": "Maximum upload date. Photos with an upload date less than or equal to this value will be returned. The date can be in the form of a unix timestamp or mysql datetime.", "in": "query", "type": "string" }, { "name": "min_taken_date", "description": "Minimum taken date. Photos with an taken date greater than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.", "in": "query", "type": "string" }, { "name": "max_taken_date", "description": "Maximum taken date. Photos with an taken date less than or equal to this value will be returned. The date can be in the form of a mysql datetime or unix timestamp.", "in": "query", "type": "string" }, { "name": "license", "description": "The license id for photos (for possible values see the flickr.photos.licenses.getInfo method). Multiple licenses may be comma-separated.", "in": "query", "type": "string" }, { "name": "sort", "description": "The order in which to sort returned photos. Deafults to date-posted-desc (unless you are doing a radial geo query, in which case the default sorting is by ascending distance from the point specified). The possible values are:\n date-posted-asc,\n date-posted-desc,\n date-taken-asc,\n date-taken-desc,\n interestingness-desc,\n interestingness-asc, and\n relevance.\n", "in": "query", "type": "string" }, { "name": "privacy_filter", "description": "Return photos only matching a certain privacy level. This only applies when making an authenticated call to view photos you own. Valid values are:,\n 1: public photos,\n 2: private photos visible to friends,\n 3: private photos visible to family,\n 4: private photos visible to friends & family,\n 5: completely private photos\n", "in": "query", "type": "number" }, { "name": "bbox", "description": "A comma-delimited list of 4 values defining the Bounding Box of the area that will be searched.", "in": "query", "type": "string" }, { "name": "accuracy", "description": "Recorded accuracy level of the location information. Current range is 1-16:\n World level is 1\n Country is ~3\n Region is ~6\n City is ~11\n Street is ~16\n", "in": "query", "type": "string" }, { "name": "safe_search", "description": "Safe search setting:\n 1: for safe,\n 2: for moderate,\n 3: for restricted\n", "in": "query", "type": "number" }, { "name": "content_type", "description": "Content Type setting:\n 1: photos only.\n 2: screenshots only.\n 3: 'other' only.\n 4: photos and screenshots.\n 5: screenshots and 'other'.\n 6: photos and 'other'.\n 7: photos, screenshots, and 'other' (all).\n", "in": "query", "type": "number" }, { "name": "machine_tags", "description": "Aside from passing in a fully formed machine tag, there is a special syntax for searching on specific properties : Find photos using the 'dc' namespace : \"machine_tags\" => \"dc:\" Find photos with a title in the 'dc' namespace : \"machine_tags\" => \"dc:title=\" Find photos titled \"mr. camera\" in the 'dc' namespace : \"machine_tags\" => \"dc:title=\\\"mr. camera\\\" Find photos whose value is \"mr. camera\" : \"machine_tags\" => \"*:*=\\\"mr. camera\\\"\" Find photos that have a title, in any namespace : \"machine_tags\" => \"*:title=\" Find photos that have a title, in any namespace, whose value is \"mr. camera\" : \"machine_tags\" => \"*:title=\\\"mr. camera\\\"\" Find photos, in the 'dc' namespace whose value is \"mr. camera\" : \"machine_tags\" => \"dc:*=\\\"mr. camera\\\"\" Multiple machine tags may be queried by passing a comma-separated list. The number of machine tags you can pass in a single query depends on the tag mode (AND or OR) that you are querying with. \"AND\" queries are limited to (16) machine tags. \"OR\" queries are limited to (8).\n", "in": "query", "type": "string" }, { "name": "machine_tag_mode", "description": "Either 'any' for an OR combination of tags, or 'all' for an AND combination. Defaults to 'any' if not specified.", "in": "query", "type": "string" }, { "name": "group_id", "description": "The id of a group who's pool to search. If specified, only matching photos posted to the group's pool will be returned.", "in": "query", "type": "string" }, { "name": "contacts", "description": "Search your contacts. Either 'all' or 'ff' for just friends and family. (Experimental)", "in": "query", "type": "string" }, { "name": "woe_id", "description": "A 32-bit identifier that uniquely represents spatial entities. (not used if bbox argument is present).", "in": "query", "type": "string" }, { "name": "place_id", "description": "A Flickr place id. (not used if bbox argument is present). Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component. A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).\n", "in": "query", "type": "string" }, { "name": "media", "description": "Filter results by media type. Possible values are all (default), photos or videos", "in": "query", "type": "string" }, { "name": "has_geo", "description": "Any photo that has been geotagged, or if the value is \"0\" any photo that has not been geotagged. Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component. A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).\n", "in": "query", "type": "string" }, { "name": "geo_context", "description": "Geo context is a numeric value representing the photo's geotagginess beyond latitude and longitude. For example, you may wish to search for photos that were taken \"indoors\" or \"outdoors\". The current list of context IDs is: 0, not defined. 1, indoors. 2, outdoors. Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component. A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).\n", "in": "query", "type": "string" }, { "name": "lat", "description": "A valid latitude, in decimal format, for doing radial geo queries. Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component. A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).\n", "in": "query", "type": "string" }, { "name": "lon", "description": "A valid longitude, in decimal format, for doing radial geo queries. Geo queries require some sort of limiting agent in order to prevent the database from crying. This is basically like the check against \"parameterless searches\" for queries without a geo component. A tag, for instance, is considered a limiting agent as are user defined min_date_taken and min_date_upload parameters — If no limiting factor is passed we return only photos added in the last 12 hours (though we may extend the limit in the future).\n", "in": "query", "type": "string" }, { "name": "radius", "description": "A valid radius used for geo queries, greater than zero and less than 20 miles (or 32 kilometers), for use with point-based geo queries. The default value is 5 (km).", "in": "query", "type": "number" }, { "name": "radius_units", "description": "The unit of measure when doing radial geo queries. Valid options are \"mi\" (miles) and \"km\" (kilometers). The default is \"km\".", "in": "query", "type": "string" }, { "name": "is_commons", "description": "Limit the scope of the search to only photos that are part of the Flickr Commons project. Default is false.", "in": "query", "type": "boolean" }, { "name": "in_gallery", "description": "Limit the scope of the search to only photos that are in a gallery? Default is false, search all photos.", "in": "query", "type": "boolean" }, { "name": "is_getty", "description": "Limit the scope of the search to only photos that are for sale on Getty. Default is false.", "in": "query", "type": "boolean" }, { "name": "per_page", "description": "Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500.", "in": "query", "type": "number" }, { "name": "page", "description": "The page of results to return. If this argument is omitted, it defaults to 1.", "in": "query", "type": "number" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "page": { "type": "number" }, "pages": { "type": "number" }, "perpage": { "type": "number" }, "total": { "type": "number" }, "photos": { "type": "array", "items": { "$ref": "#/definitions/Photo" } } } } } } } }, "/upload": { "post": { "operationId": "uploadPhoto", "description": "Uploads a new photo to Flickr", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "formData", "required": true, "type": "string" }, { "name": "photo", "in": "formData", "required": true, "type": "file" }, { "name": "title", "in": "formData", "required": false, "type": "string" }, { "name": "description", "in": "formData", "required": false, "type": "string" }, { "name": "tags", "in": "formData", "required": false, "type": "string" }, { "name": "is_public", "in": "formData", "required": false, "type": "string", "enum": [ "0", "1" ] }, { "name": "is_friend", "in": "formData", "required": false, "type": "string", "enum": [ "0", "1" ] }, { "name": "is_family", "in": "formData", "required": false, "type": "string", "enum": [ "0", "1" ] }, { "name": "safety_level", "in": "formData", "required": false, "type": "string", "enum": [ "1", "2", "3" ] }, { "name": "content_type", "in": "formData", "required": false, "type": "string", "enum": [ "1", "2", "3" ] }, { "name": "hidden", "in": "formData", "required": false, "type": "string", "enum": [ "1", "2" ] } ], "responses": { "200": { "description": "OK", "schema": { "type": "object" } } } } }, "/rest?method=flickr.test.echo": { "get": { "operationId": "echo", "description": "Echos the input parameters back in the response", "tags": [ "Public" ], "parameters": [ { "name": "api_key", "in": "query", "required": true, "type": "string" }, { "name": "echo", "in": "query", "required": false, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "object", "properties": { "echo": { "type": "object", "properties": { "_content": { "type": "string" } } } } } } } } }, "/oauth/request_token": { "get": { "operationId": "getRequestToken", "description": "Returns an oauth token and oauth token secret", "tags": [ "Public" ], "parameters": [ { "name": "oauth_consumer_key", "in": "query", "required": true, "type": "string" }, { "name": "oauth_nonce", "in": "query", "required": true, "type": "string" }, { "name": "oauth_timestamp", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "oauth_signature_method", "in": "query", "required": true, "type": "string" }, { "name": "oauth_version", "in": "query", "required": true, "type": "string" }, { "name": "oauth_signature", "in": "query", "required": true, "type": "string" }, { "name": "oauth_callback", "in": "query", "required": true, "type": "string", "pattern": "^http.*$" } ], "responses": { "200": { "description": "OK", "schema": { "type": "string" } } } } }, "/oauth/access_token": { "get": { "operationId": "getAccessToken", "description": "Returns an access token", "tags": [ "Public" ], "parameters": [ { "name": "oauth_consumer_key", "in": "query", "required": true, "type": "string" }, { "name": "oauth_nonce", "in": "query", "required": true, "type": "string" }, { "name": "oauth_timestamp", "in": "query", "required": true, "type": "string", "pattern": "^[0-9]+$" }, { "name": "oauth_signature_method", "in": "query", "required": true, "type": "string" }, { "name": "oauth_version", "in": "query", "required": true, "type": "string" }, { "name": "oauth_signature", "in": "query", "required": true, "type": "string" }, { "name": "oauth_verifier", "in": "query", "required": true, "type": "string" }, { "name": "oauth_token", "in": "query", "required": true, "type": "string" } ], "responses": { "200": { "description": "OK", "schema": { "type": "string" } } } } } }, "definitions": { "ContextPhoto": { "type": "object", "properties": { "id": { "type": "string" }, "secret": { "type": "string" }, "server": { "type": "string" }, "farm": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" }, "thumb": { "type": "string" }, "media": { "type": "string" }, "owner": { "type": "string" }, "license": { "type": "integer" }, "safe": { "type": "boolean" }, "is_faved": { "type": "boolean" } } }, "ContextPhotos": { "type": "object", "properties": { "photos": { "type": "array", "items": { "$ref": "#/definitions/ContextPhoto" } } } }, "Cover": { "type": "object", "properties": { "id": { "type": "string" }, "owner": { "type": "string" }, "secret": { "type": "string" }, "server": { "type": "string" }, "farm": { "type": "string" }, "title": { "type": "string" }, "ispublic": { "type": "boolean" }, "isfriend": { "type": "boolean" }, "isfamily": { "type": "boolean" }, "y": { "type": "string" } } }, "Group": { "type": "object", "properties": { "id": { "type": "string" }, "path_alias": { "type": "string" }, "iconserver": { "type": "string" }, "iconfarm": { "type": "string" }, "name": { "type": "object", "properties": { "_content": { "type": "string" } } }, "description": { "type": "object", "properties": { "_content": { "type": "string" } } }, "rules": { "type": "object", "properties": { "_content": { "type": "string" } } }, "members": { "type": "object", "properties": { "_content": { "type": "string" } } }, "pool_count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "topic_count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "privacy": { "type": "object", "properties": { "_content": { "type": "string" } } }, "lang": { "type": "string" }, "ispoolmoderated": { "type": "boolean" }, "roles": { "type": "object", "properties": { "member": { "type": "string" }, "moderator": { "type": "string" }, "admin": { "type": "string" } } }, "pool_rows": { "type": "integer" }, "coverphoto_server": { "type": "string" }, "coverphoto_farm": { "type": "string" }, "coverphoto_url": { "$ref": "#/definitions/PhotoURLs" }, "is_member": { "type": "boolean" }, "is_moderator": { "type": "boolean" }, "is_admin": { "type": "boolean" }, "blast": { "type": "object", "properties": { "_content": { "type": "string" }, "date_blast_added": { "type": "string" }, "user_id": { "type": "string" } } }, "throttle": { "type": "object", "properties": { "count": { "type": "integer" }, "mode": { "type": "string" }, "remaining": { "type": "string" } } }, "restrictions": { "type": "object", "properties": { "photos_ok": { "type": "boolean" }, "videos_ok": { "type": "boolean" }, "images_ok": { "type": "boolean" }, "screens_ok": { "type": "boolean" }, "art_ok": { "type": "boolean" }, "safe_ok": { "type": "boolean" }, "moderate_ok": { "type": "boolean" }, "restricted_ok": { "type": "boolean" }, "has_geo": { "type": "boolean" } } }, "cover": { "$ref": "#/definitions/Cover" } } }, "Note": { "type": "object", "properties": { "description": { "type": "string" } } }, "Owner": { "type": "object", "properties": { "nsid": { "type": "string" }, "username": { "type": "string" }, "realname": { "type": "string" }, "location": { "type": "string" }, "iconserver": { "type": "string" }, "iconfarm": { "type": "string" }, "path_alias": { "type": "string" }, "noindexfollow": { "type": "boolean" }, "ispro": { "type": "boolean" }, "is_ad_free": { "type": "boolean" } } }, "Person": { "type": "object", "properties": { "id": { "type": "string" }, "nsid": { "type": "string" }, "ispro": { "type": "boolean" }, "can_buy_pro": { "type": "boolean" }, "iconserver": { "type": "string" }, "iconfarm": { "type": "string" }, "path_alias": { "type": "string" }, "has_stats": { "type": "boolean" }, "coverphoto_server": { "type": "string" }, "coverphoto_farm": { "type": "string" }, "is_ad_free": { "type": "boolean" }, "coverphoto": { "$ref": "#/definitions/PhotoURLs" }, "expire": { "type": "boolean" }, "user_secret": { "type": "string" }, "username": { "type": "object", "properties": { "_content": { "type": "string" } } }, "realname": { "type": "object", "properties": { "_content": { "type": "string" } } }, "mbox_sha1sum": { "type": "object", "properties": { "_content": { "type": "string" } } }, "location": { "type": "object", "properties": { "_content": { "type": "string" } } }, "timezone": { "type": "object", "properties": { "label": { "type": "string" }, "offset": { "type": "string" }, "timezone_id": { "type": "string" } } }, "description": { "type": "object", "properties": { "_content": { "type": "string" } } }, "photosurl": { "type": "object", "properties": { "_content": { "type": "string" } } }, "profileurl": { "type": "object", "properties": { "_content": { "type": "string" } } }, "mobileurl": { "type": "object", "properties": { "_content": { "type": "string" } } }, "photos": { "type": "object", "properties": { "firstdatetaken": { "type": "object", "properties": { "_content": { "type": "string" } } }, "firstdate": { "type": "object", "properties": { "_content": { "type": "string" } } }, "count": { "type": "object", "properties": { "_content": { "type": "string" } } }, "views": { "type": "object", "properties": { "_content": { "type": "string" } } } } }, "yintl": { "type": "string" }, "unread_messages": { "type": "object", "properties": { "_content": { "type": "string" } } }, "cover": { "$ref": "#/definitions/Cover" }, "disable_keyboard_shortcuts": { "type": "object", "properties": { "_content": { "type": "string" } } } } }, "Photo": { "type": "object", "properties": { "id": { "type": "string" }, "secret": { "type": "string" }, "server": { "type": "string" }, "farm": { "type": "string" }, "dateuploaded": { "type": "string" }, "isfavorite": { "type": "boolean" }, "license": { "type": "string" }, "safety_level": { "type": "string" }, "rotation": { "type": "string" }, "originalsecret": { "type": "string" }, "owner": { "$ref": "#/definitions/Owner" }, "title": { "type": "object", "properties": { "_content": { "type": "string" } } }, "description": { "type": "object", "properties": { "_content": { "type": "string" } } }, "visibility": { "type": "object", "properties": { "ispublic": { "type": "boolean" }, "isfriend": { "type": "boolean" }, "isfamily": { "type": "boolean" } } }, "dates": { "type": "object", "properties": { "posted": { "type": "string" }, "taken": { "type": "string" }, "takengranularity": { "type": "string" }, "takenunknown": { "type": "boolean" }, "lastupdate": { "type": "string" } } }, "permissions": { "type": "object", "properties": { "permcomment": { "type": "string" }, "permaddmeta": { "type": "string" } } }, "views": { "type": "string" }, "editability": { "type": "object", "properties": { "cancomment": { "type": "boolean" }, "canaddmeta": { "type": "boolean" } } }, "publiceditability": { "type": "object", "properties": { "cancomment": { "type": "boolean" }, "canaddmeta": { "type": "boolean" } } }, "usage": { "type": "object", "properties": { "candownload": { "type": "boolean" }, "canblog": { "type": "boolean" }, "canprint": { "type": "boolean" }, "canshare": { "type": "boolean" } } }, "comments": { "type": "object", "properties": { "_content": { "type": "string" } } }, "notes": { "type": "object", "properties": { "note": { "type": "array", "items": { "$ref": "#/definitions/Note" } } } }, "people": { "type": "object", "properties": { "haspeople": { "type": "boolean" } } }, "tags": { "type": "object", "properties": { "tag": { "type": "array", "items": { "$ref": "#/definitions/Tag" } } } }, "urls": { "type": "object", "properties": { "url": { "type": "array", "items": { "$ref": "#/definitions/URL" } } } }, "safe": { "type": "boolean" }, "media": { "type": "string" } } }, "PhotoURLs": { "type": "object", "properties": { "h": { "type": "string" }, "l": { "type": "string" }, "s": { "type": "string" }, "t": { "type": "string" } } }, "Stat": { "type": "string" }, "Tag": { "type": "object", "properties": { "id": { "type": "string" }, "author": { "type": "string" }, "authorname": { "type": "string" }, "raw": { "type": "string" }, "_content": { "type": "string" }, "machine_tag": { "type": "boolean" } } }, "Topic": { "type": "object", "properties": { "id": { "type": "string" }, "subject": { "type": "string" }, "message": { "type": "object", "properties": { "_content": { "type": "string" } } }, "author": { "type": "string" }, "authorname": { "type": "string" }, "author_path_alias": { "type": "string" }, "author_is_deleted": { "type": "boolean" }, "is_pro": { "type": "boolean" }, "role": { "type": "string" }, "iconserver": { "type": "string" }, "iconfarm": { "type": "string" }, "count_replies": { "type": "integer" }, "can_edit": { "type": "boolean" }, "can_delete": { "type": "boolean" }, "can_reply": { "type": "boolean" }, "is_sticky": { "type": "boolean" }, "is_locked": { "type": "boolean" }, "datecreate": { "type": "string" }, "datelastpost": { "type": "string" }, "last_reply": { "type": "string" }, "lastedit": { "type": "string" } } }, "TopicReply": { "type": "object", "properties": { "id": { "type": "string" }, "message": { "type": "object", "properties": { "_content": { "type": "string" } } }, "author": { "type": "string" }, "authorname": { "type": "string" }, "author_path_alias": { "type": "string" }, "author_is_deleted": { "type": "boolean" }, "is_pro": { "type": "boolean" }, "iconserver": { "type": "string" }, "iconfarm": { "type": "string" }, "can_edit": { "type": "boolean" }, "can_delete": { "type": "boolean" }, "datecreate": { "type": "string" }, "lastedit": { "type": "string" } } }, "URL": { "type": "object", "properties": { "type": { "type": "string" }, "_content": { "type": "string" } } }, "Album": { "type": "object", "properties": { "id": { "type": "string" }, "primary": { "type": "string" }, "secret": { "type": "string" }, "server": { "type": "string" }, "farm": { "type": "string" }, "photos": { "type": "number" }, "videos": { "type": "number" }, "count_views": { "type": "number" }, "count_comments": { "type": "number" }, "can_comment": { "type": "boolean" }, "date_create": { "type": "number" }, "date_update": { "type": "number" }, "title": { "type": "string" }, "description": { "type": "string" } } }, "Size": { "type": "object", "properties": { "label": { "type": "string" }, "width": { "type": "number" }, "height": { "type": "number" }, "source": { "type": "string" }, "url": { "type": "string" }, "media": { "type": "string" } } } } }