Rechercher une page de manuel
flickcurl
Langue: en
Version: 260411 (debian - 07/07/09)
Section: 1 (Commandes utilisateur)
NAME
flickcurl - call Flickr APISYNOPSIS
flickcurl -a FROBflickcurl [-d DELAY] [-h] [-o FILE] [-q] [-v] [-V] [commands] ...
DESCRIPTION
flickcurl is a utility program to call the Flickr APIs via the flickcurl library. Run flickcurl -h to get a list of the supported commands and their arguments.The program requires configuring before use to work with the Flickr APIs. Run flickcurl without any options to get the instructions for registering the application and creating the initial configuration file ~/.flickcurl.conf from the registration information.
OPTIONS
These programs follow the usual GNU command line syntax, with long options starting with two dashes (`-'). A summary of options is included below.- -a FROB, --auth FROB
- Authenticate with a FROB and update the authentication file. The program will exit after updating the file.
- -d DELAY, --delay DELAY
- Set delay between requests to DELAY milliseconds.
- -h, --help
- Show summary of options and exit.
- -o FILE, --output FILE
- Write the results of format feed API calls to FILE
- -q, --quiet
- Display less information while the program runs.
- -v, --version
- Display the version of the program and exit.
- -V, --verbose
- Display more information while the program runs.
COMMANDS
- activity.userComments [PER-PAGE [PAGE]]
- Get photos commented on by the caller.
- activity.userPhotos [TIMEFRAME [PER-PAGE [PAGE]]]
- Get recent activity on the caller's photos.
- auth.checkToken TOKEN
- Get the credentials attached to an authentication TOKEN.
- auth.getFrob
- Get a frob to be used during authentication.
- auth.getFullToken MINI-TOKEN
- Get the full authentication token for MINI-TOKEN.
- auth.getToken TOKEN
- Get the auth token for the FROB, if one has been attached.
- blogs.getList
- Get a list of configured blogs for the calling user.
- blogs.postPhoto BLOG-ID PHOTO-ID TITLE DESCRIPTION [BLOG-PASSWORD]
- Post PHOTO-ID to blog BLOG-ID with TITLE, DESCRIPTION and optional password.
- commons.getInstitutions
- Get list of institutions
- contacts.getList [FILTER [PER-PAGE [PAGE]]]
- Get a list of contacts with optional FILTER
- contacts.getListRecentlyUploaded [DATE-LAST-UPLOAD [FILTER]]
- Get a list of recent uploading contacts since DATE-LAST-UPLOAD with optional FILTER
- favorites.add PHOTO-ID
- Adds PHOTO-ID to the current user's favorites.
- favorites.getList USER-NSID [[PER-PAGE] [PAGE [FORMAT]]]
- Get a list of USER-NSID's favorite photos.
- favorites.getPublicList USER-NSID [[PER-PAGE] [PAGE [FORMAT]]]
- Get a list of USER-NSID's favorite public photos.
- favorites.remove PHOTO-ID
- Removes PHOTO-ID to the current user's favorites.
- groups.browse [CAT-ID]
- Browse groups below category CAT-ID (or root).
- groups.getInfo GROUP-ID [LANG]
- Get information on group GROUP-ID with language LANG.
- groups.members.getList GROUP-ID [MEMBER-TYPES [PER-PAGE [PAGE]]]
- Get list of MEMBER-TYPES types members of group GROUP-ID.
- groups.pools.add PHOTO-ID GROUP-ID
- Add PHOTO-ID in GROUP-ID pool.
- groups.pools.getContext PHOTO-ID GROUP-ID
- Get next and previous photos for PHOTO-ID in GROUP-ID pool.
- groups.pools.getGroups [PAGE [PER-PAGE]]
- Get list of groups a user can add to.
- groups.pools.getPhotos GROUP-ID [PAGE [PER-PAGE [FORMAT]]]
- Get list of photos in GROUP-ID.
- groups.pools.remove PHOTO-ID GROUP-ID
- Remove PHOTO-ID from group GROUP-ID.
- groups.search TEXT [PER-PAGE [PAGE]]
- Search for groups matching TEXT paging PER-PAGE and PAGE.
- interestingness.getList [PARAMS]
- Get interesting photos with optional parameters
date DATE
extras EXTRAS
per-page PER-PAGE
page PAGE
format FORMAT - machinetags.getNamespaces [PREDICATE [PER-PAGE [PAGE]]]
- Get a list of namespaces with optional PREDICATE
- machinetags.getPairs [NAMESPACE [PREDICATE [PER-PAGE [PAGE]]]]
- Get a list of unique NAMESPACE and PREDICATE pairs
- machinetags.getPredicates [NAMESPACE [PER-PAGE [PAGE]]]
- Get a list of unique predicates optionally by NAMESPACE
- machinetags.getValues NAMESPACE PREDICATE [PER-PAGE [PAGE]]
- Get a list of unique values for a NAMESPACE and PREDICATE
- panda.getList
- get the current list of pandas
- panda.getPhotos PANDA
- ask a PANDA for a list of recent public and safe photos
- people.findByEmail EMAIL
- get a user's NSID from their EMAIL address
- people.findByUsername USERNAME
- get a user's NSID from their USERNAME
- people.getInfo USER-NSID
- Get information about one person with id USER-NSID
- people.getPublicGroups USER-NSID
- Get list of public groups a user is amember of
- people.getPublicPhotos USER-NSID [PER-PAGE [PAGE [FORMAT]]]
- Get public photos for a user USER-NSID
- people.getUploadStatus
- Get calling user upload status
- photos.addTags PHOTO-ID TAGS
- Add TAGS to a PHOTO-ID.
- photos.comments.addComment PHOTO-ID TEXT
- Add a photo comment TEXT to PHOTO-ID.
- photos.comments.deleteComment COMMENT-ID
- Delete a photo comment COMMENT-ID.
- photos.comments.editComment COMMENT-ID TEXT
- Edit a photo comment COMMENT-ID to have new TEXT.
- photos.comments.getList PHOTO-ID
- Get the comments for a photo PHOTO-ID.
- photos.delete PHOTO-ID
- Delete a PHOTO-ID.
- photos.geo.getLocation PHOTO-ID
- Get the geo location for a photo PHOTO-ID.
- photos.geo.getPerms PHOTO-ID
- Get the geo perms for a photo PHOTO-ID.
- photos.geo.removeLocation PHOTO-ID
- Remove the location for a photo PHOTO-ID.
- photos.geo.removeLocation PHOTO-ID LAT LONG ACCURACY
- Set the location for a photo PHOTO-ID.
- photos.geo.setPerms PHOTO-ID IS-PUBLIC IS-CONTACT IS-FRIEND IS-FAMILY
- Set the geo perms for a photo PHOTO-ID.
- photos.getAllContexts PHOTO-ID
- Get all visible sets and pools the PHOTO-ID belongs to.
- photos.getContactsPhotos
- Get a list of recent photos from the calling users' contacts
- photos.getContactsPublicPhotos USER-NSID [FORMAT]
- Get a list of recent public photos from USER-NSID's contacts
- photos.getContext PHOTO-ID
- Get next and previous photos for a PHOTO-ID in a photostream.
- photos.getCounts DATES TAKEN-DATES
- Get the counts for a set of DATES or TAKEN-DATES.
- photos.getExif PHOTO-ID
- Get EXIF information about one photo with id PHOTO-ID
- photos.getFavorites PHOTO-ID [PER-PAGE [PAGE]]
- Get favourites information about one photo with id PHOTO-ID
- photos.getInfo PHOTO-ID
- Get information about one photo with id PHOTO-ID
- photos.getNotInSet [PER-PAGE [PAGE [FORMAT]]]
- Get list of photos that are not in any set
- photos.getPerms PHOTO-ID
- Get a photo viewing and commenting permissions
- photos.getRecent [PER-PAGE [PAGE [FORMAT]]]
- Get list of recent photos
- photos.getSizes PHOTO-ID
- Get sizes of a PHOTO-ID
- photos.getUntagged [PER-PAGE [PAGE [FORMAT]]]
- Get list of photos that are not tagged
- photos.getWithGeoData [PER-PAGE [PAGE [FORMAT]]]
- Get list of photos that have geo data
- photos.getWithoutGeoData [PER-PAGE [PAGE [FORMAT]]]
- Get list of photos that do not have geo data
- photos.licenses.getInfo
- Get list of available photo licenses
- photos.licenses.setLicense PHOTO-ID LICENSE-ID
- Get photo PHOTO-ID license to LICENSE-ID
- photos.notes.add PHOTO-ID X Y W H TEXT
- Add a note (X, Y, W, H, TEXT) to a photo with id PHOTO-ID
- photos.notes.delete NOTE-ID
- Delete a note with id NOTE-ID
- photos.notes.edit NOTE-ID X Y W H TEXT
- Edit note NOTE-ID to (X, Y, W, H, TEXT)
- photos.recentlyUpdated MIN-DATE [PER-PAGE [PAGE [FORMAT]]]
- Get list of photos that were recently updated
- photos.removeTag PHOTO-ID TAG-ID
- Remove a tag TAG-ID from a photo.
- photos.search [PARAMS] tags TAGS...
- Search for photos/videos with many optional parameters
user USER
tag-mode any|all
text TEXT
(min|max)-(upload|taken)-date DATE
license LICENSE
privacy PRIVACY
bbox a,b,c,d
sort date-(posted|taken)-(asc|desc)|interestingness-(desc|asc)|relevance
accuracy 1-16
safe-search 1-3
type 1-4
machine-tags TAGS
machine-tag-mode any|all
group-id ID
place-id ID
extras EXTRAS
per-page PER-PAGE
page PAGES
media all|photos|videos
has-geo
lat LAT lon LON radius RADIUS radius-units km|mi
contacts (all|ff)
format FORMAT - photos.setContentType PHOTO-ID TYPE
- Set photo TYPE to one of 'photo', 'screenshot' or 'other'
- photos.setDates PHOTO-ID POSTED TAKEN GRANULARITY
- Set a photo POSTED date, TAKEN date with GRANULARITY
- photos.setMeta PHOTO-ID TITLE DESCRIPTION
- Set a photo TITLE and DESCRIPTION
- photos.setPerms PHOTO-ID IS-PUBLIC IS-FRIEND IS-FAMILY PERM-COMMENT PERM-ADDMETA
- Set a photo viewing and commenting permissions
- photos.setSafetyLevel PHOTO-ID SAFETY-LEVEL HIDDEN
- Set a photo's SAFETY-LEVEL and HIDDEN flag
- photos.setTags PHOTO-ID TAGS
- Set the tags for a PHOTO-ID to TAGS.
- photos.transform.rotate PHOTO-ID DEGREES
- Rotate PHOTO-ID by 90/180/270 DEGREES
- photos.upload.checkTickets TICKET-IDS...
- Get the status of upload TICKET-IDS
- photosets.addPhoto PHOTOSET-ID PHOTO-ID
- Add PHOTO-ID to a PHOTOSET-ID.
- photosets.comments.addComment PHOTOSET-ID TEXT
- Add a comment TEXT to photoset PHOTOSET-ID.
- photosets.comments.deleteComment COMMENT-ID
- Delete a photoset comment COMMENT-ID.
- photosets.comments.editComment COMMENT-ID TEXT
- Edit a photoset comment COMMENT-ID to have new TEXT.
- photosets.comments.getList PHOTOSET-ID
- Get the comments for a photoset PHOTOSET-ID.
- photosets.create TITLE DESCRIPTION PRIMARY-PHOTO-ID
- Create a photoset with TITLE, DESCRIPTION and PRIMARY-PHOTO-ID.
- photosets.delete PHOTOSET-ID
- Delete a photoset with PHOTOSET-ID.
- photosets.editMeta PHOTOSET-ID TITLE DESCRIPTION
- Set the TITLE and/or DESCRIPTION of a PHOTOSET-ID.
- photosets.editPhotos PHOTOSET-ID PRIMARY-PHOTO-ID PHOTO-IDS...
- Set the PHOTO-IDs of a PHOTOSET-ID and PRIMARY-PHOTO-ID.
- photosets.getContext PHOTO-ID PHOTOSET-ID
- Get next and previous photos for PHOTO-ID in PHOTOSET-ID.
- photosets.getInfo PHOTOSET-ID
- Get information about PHOTOSET-ID.
- photosets.getList [USER-NSID]
- Get the list of photosets for the USER-NSID.
- photosets.getPhotos PHOTOSET-ID [EXTRAS [PRIVACY [PER-PAGE [PAGE [FORMAT]]]]]
- Get the list of photos in PHOTOSET-ID with options.
- photosets.orderSets PHOTOSET-IDS...
- Set the order of sets PHOTOSET-IDS.
- photosets.removePhoto PHOTOSET-ID PHOTO-ID
- Remove PHOTO-ID from PHOTOSET-ID.
- places.find TEXT
- Find places by TEXT query.
- places.findByLatLon LAT LON ACCURACY
- Find places by LAT and LON with ACCURACY 1-16.
- places.getChildrenWithPhotosPublic PLACE-ID|- [WOE-ID|-]
- Find child places with public photos by PLACE-ID or WOE-ID
- places.getInfo PLACE-ID|- [WOE-ID|-]
- Find place by PLACE-ID or WOE-ID
- places.getInfoByUrl URL
- Find place by place URL
- places.getPlaceTypes URL
- Get a list of available place types
- places.getShapeHistory PLACE-ID|- [WOE-ID|-]
- Get history of shapes for a place by PLACE-ID or WOE-ID
- places.placesForBoundingBox PLACE-TYPE MIN-LONG MIN-LAT MAX-LONG MAX-LAT
- Find user places of PLACE-TYPE in bbox.
- places.placesForContacts PLACE-TYPE WOE-ID|- PLACE-ID|- THRESHOLD [PARAMS]
- Find top 100 unique places clustered by a given PLACE-TYPE for a
user's contacts with optional parameters
contacts CONTACTS
min-upload MIN-UPLOAD-DATE
max-upload MAX-UPLOAD-DATE
min-taken MIN-TAKEN-DATE
max-taken MAX-TAKEN-DATE - places.placesForUser PLACE-TYPE [WOE-ID] [PLACE-ID [THRESHOLD]]]
- Find user places of PLACE-TYPE.
- places.resolvePlaceId PLACE-ID / WOE-ID
- Find places information by PLACE-ID or WOE-ID (number).
- places.resolvePlaceURL PLACE-URL
- Find places information by PLACE-URL.
- places.tagsForPlace PLACE-ID|- [WOE-ID|-]
- Get tags for a place by PLACE-ID or WOE-ID with optional parameters
min-upload MIN-UPLOAD-DATE
max-upload MAX-UPLOAD-DATE
min-taken MIN-TAKEN-DATE
max-taken MAX-TAKEN-DATE - prefs.getContentType
- Get default content type preference for user.
- prefs.getGeoPerms
- Get default privacy level for geographic info for user.
- prefs.getHidden
- Get default hidden preference for user.
- prefs.getPrivacy
- Get default privacy preference for user.
- prefs.getSafetyLevel
- Get default safety level for user.
- reflection.getMethodInfo NAME
- Get information about an API method NAME
- reflection.getMethods
- Get API methods
- replace FILE PHOTO-ID [async]
- Replace a photo PHOTO-ID with a new FILE (async)
- tags.getClusters TAG
- Get list of tag clusters for TAG
- tags.getHotList [PERIOD [COUNT]]
- Get the list of hot tags for the given PERIOD (day, week)
- tags.getListPhoto PHOTO-ID
- Get the tag list for a PHOTO-ID.
- tags.getListUser [USER-NSID]
- Get the tag list for a USER-NSID (or current user).
- tags.getListUserPopular [USER-NSID [COUNT]]
- Get the popular tag list for a USER-NSID (or current user).
- tags.getListUserRaw [TAG]
- Get the raw versions of a TAG (or all tags) for the current user.
- tags.getRelated TAG
- Get a list of tags 'related' to TAG based on clustered usage analysis.
- test.echo KEY VALUE
- Test echo API call; echos KEY VALUE
- test.login
- Test login API call: returns username
- test.null KEY VALUE
- Test null API call: no return
- upload FILE [PARAMS...]
- Upload a photo FILE with optional parameters PARAM or PARAM VALUE
title TITLE
description DESC
tags TAGS...
friend
public
family - urls.getGroup GROUP-ID
- Get the url of the group page for GROUP-ID.
- urls.getUserPhotos USER-NSID
- Get the url of the photo page for USER-NSID.
- urls.getUserProfile USER-NSID
- Get the url of the profile page for USER-NSID.
- urls.lookupGroup URL
- Get a group NSID from the URL to a group's page or photo pool.
- urls.lookupUser URL
- Get a user NSID from the URL to a user's photo
Extras Fields
The EXTRAS parameter can take a comma-separated set of the following values- date_taken
- Date item was taken
- date_upload
- Date item was uploaded
- geo
- Geotagging latitude, longitude and accuracy
- icon_server
- Item owner icon fields
- last_update
- Date item was last updated
- license
- Item License
- machine_tags
- Machine tags
- media
- Item Format: photo or video
- o_dims
- Original item dimensions
- original_format
- Original item secret and format
- owner_name
- Item owner ID
- tags
- Item clean tags (safe for HTML, URLs)
- views
- Number of times item has been viewed
Photos List Feed Formats
The FORMAT parameter can take any of the following values- feed-rss_100
- RSS 1.0
- feed-rss_200
- RSS 2.0
- feed-atom_10
- Atom 1.0
- feed-georss
- RSS 2.0 with GeoRSS and W3C Geo for geotagged photos
- feed-geoatom
- Atom 1.0 with GeoRSS and W3C Geo for geotagged photos
- feed-geordf
- RSS 1.0 with GeoRSS and W3C Geo for geotagged photos
- feed-kml
- KML 2.1
- feed-kml_nl
- KML 2.1 network link
SEE ALSO
flickrdf(1).AUTHOR
flickcurl was written by David Beckett.This manual page was written by Kumar Appaiah <akumar@ee.iitm.ac.in>, for the Debian project (but may be used by others).
Contenus ©2006-2024 Benjamin Poulain
Design ©2006-2024 Maxime Vantorre