.TH FLICKCURL 1 "1 September 2008"
.SH "نام (NAME)"
flickcurl \- ابزار خط فرمان فراخوانی وب‌سرویس‌های فلیکر (Flickr)
.SH "خلاصه دستور (SYNOPSIS)"
.B flickcurl
\fB\-a \fIFROB\fP\fR
.br
.B flickcurl
[\fB\-d \fIDELAY\fP\fR] [\fB\-h\fR] [\fB\-o FILE\fR] [\fB\-q\fR] [\fB\-v\fR] [\fB\-V\fR] [\fIدستورات\fR] ...
.br
.SH "توضیحات (DESCRIPTION)"
\fBflickcurl\fP ابزاری کاربردی برای فراخوانی APIهای فلیکر (Flickr) از طریق
کتابخانه flickcurl است. برای دریافت فهرستی از دستورات پشتیبانی‌شده و آرگومان‌های آن‌ها،
دستور \fIflickcurl \-h\fP را اجرا کنید.
.LP
این برنامه پیش از استفاده و برای کار با APIهای فلیکر نیاز به پیکربندی دارد.
دستور \fBflickcurl\fP را بدون هیچ گزینه‌ای اجرا کنید تا دستورالعمل‌های ثبت برنامه
و ایجاد فایل پیکربندی اولیه \fI~/.flickcurl.conf\fP از اطلاعات ثبت‌نام
نمایش داده شود.
.SH "گزینه‌ها (OPTIONS)"
این برنامه‌ها از ساختار معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های
طولانی با دو خط تیره (`-') آغاز می‌شوند.
خلاصه‌ای از گزینه‌ها در زیر آمده است:
.TP
.B \-a \fIFROB\fP, \-\-auth \fIFROB\fP
احراز هویت با یک \fIFROB\fP و به‌روزرسانی فایل احراز هویت.
برنامه پس از به‌روزرسانی فایل خارج خواهد شد.
.TP
.B \-d \fIDELAY\fP, \-\-delay \fIDELAY\fP
تنظیم تاخیر میان درخواست‌ها به میزان \fIDELAY\fP میلی‌ثانیه.
.TP
.B \-h, \-\-help
نمایش چکیده گزینه‌ها و خروج.
.TP
.B \-o \fIFILE\fP, \-\-output \fIFILE\fP
نوشتن نتایج فراخوانی‌های API فید قالب‌بندی‌شده در \fIFILE\fP.
.TP
.B \-q, \-\-quiet
نمایش اطلاعات کمتر هنگام اجرای برنامه.
.TP
.B \-v, \-\-version
نمایش نسخه برنامه و خروج.
.TP
.B \-V, \-\-verbose
نمایش اطلاعات بیشتر و با جزئیات هنگام اجرای برنامه.
.SH "دستورات (COMMANDS)"
.LP
در فهرست دستورات زیر:
.br
\fIPER-PAGE\fR تعداد عکس‌ها در هر صفحه نتایج است، یا '-' برای مقدار پیش‌فرض (۱۰)
.br
\fIPAGE\fR شماره صفحه نتایج است، یا '-' برای مقدار پیش‌فرض (۱ = نخستین صفحه)
.IP "\fBactivity.userComments\fP \fI[PER-PAGE [PAGE]]\fP"
دریافت عکس‌هایی که توسط فراخواننده روی آن‌ها دیدگاه گذاشته شده است.
.IP "\fBactivity.userPhotos\fP \fI[TIMEFRAME [PER-PAGE [PAGE]]]\fP"
دریافت فعالیت‌های اخیر روی عکس‌های کاربر فراخواننده.
.IP "\fBauth.checkToken\fP \fITOKEN\fP"
دریافت اطلاعات هویتی متصل به یک نشانه (TOKEN) احراز هویت.
.IP "\fBauth.getFrob\fP \fI\fP"
دریافت یک frob جهت استفاده در فرآیند احراز هویت.
.IP "\fBauth.getFullToken\fP \fIMINI-TOKEN\fP"
دریافت نشانه کامل احراز هویت برای MINI-TOKEN.
.IP "\fBauth.getToken\fP \fITOKEN\fP"
دریافت نشانه احراز هویت برای FROB، در صورتی که متصل شده باشد.
.IP "\fBblogs.getList\fP \fI\fP"
دریافت فهرستی از وبلاگ‌های پیکربندی‌شده برای کاربر فراخواننده.
.IP "\fBblogs.getServices\fP \fI\fP"
دریافت فهرستی از سرویس‌های وبلاگ.
.IP "\fBblogs.postPhoto\fP \fIBLOG-ID PHOTO-ID TITLE DESCRIPTION [BLOG-PASSWORD]\fP"
ارسال PHOTO-ID به وبلاگ BLOG-ID همراه با TITLE، DESCRIPTION و گذرواژه اختیاری.
.IP "\fBcollections.getInfo\fP \fICOLLECTION-ID\fP"
دریافت اطلاعات درباره مجموعه COLLECTION-ID.
.IP "\fBcollections.getTree\fP \fI[COLLECTION-ID|- [USER-ID|-]]\fP"
دریافت درخت مجموعه‌های COLLECTION-ID برای USER-ID.
.IP "\fBcommons.getInstitutions\fP \fI\fP"
دریافت فهرست موسسات.
.IP "\fBcontacts.getList\fP \fI[FILTER [PER-PAGE [PAGE]]]\fP"
دریافت فهرستی از مخاطبان با FILTER اختیاری.
.IP "\fBcontacts.getListRecentlyUploaded\fP \fI[DATE-LAST-UPLOAD [FILTER]]\fP"
دریافت فهرستی از مخاطبانی که اخیراً از تاریخ DATE-LAST-UPLOAD بارگذاری کرده‌اند همراه با FILTER اختیاری.
.IP "\fBcontacts.getPublicList\fP \fIUSER-NSID [PER-PAGE [PAGE]]\fP"
دریافت فهرست مخاطبان عمومی برای کاربر USER-NSID.
.IP "\fBcontacts.getTaggingSuggestions\fP \fI[PER_PAGE [PAGE [INCLUDE-SELF [INCLUDE-ADDRESS-BOOK]]]]\fP"
دریافت پیشنهادهای برچسب‌گذاری.
.IP "\fBfavorites.add\fP \fIPHOTO-ID\fP"
افزودن PHOTO-ID به علاقه‌مندی‌های کاربر جاری.
.IP "\fBfavorites.getContext\fP \fIPHOTO-ID USER-NSID [NUM-PREV [NUM-NEXT [EXTRAS]]]\fP"
دریافت عکس‌های پیرامون عکس برگزیده PHOTO-ID متعلق به USER-ID.
.IP "\fBfavorites.getList\fP \fIUSER-NSID [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرستی از عکس‌های برگزیده USER-NSID.
.IP "\fBfavorites.getPublicList\fP \fIUSER-NSID [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرستی از عکس‌های برگزیده عمومی USER-NSID.
.IP "\fBfavorites.remove\fP \fIPHOTO-ID\fP"
حذف PHOTO-ID از علاقه‌مندی‌های کاربر جاری.
.IP "\fBgalleries.addPhoto\fP \fIGALLERY-ID PHOTO-ID TEXT\fP"
افزودن عکس PHOTO-ID به نگارخانه GALLERY-ID به همراه متن TEXT.
.IP "\fBgalleries.create\fP \fITITLE [DESCRIPTION [PRIMARY-PHOTO-ID]\fP"
ایجاد یک نگارخانه جدید با TITLE، DESCRIPTION و PRIMARY-PHOTO_ID.
.IP "\fBgalleries.editMeta\fP \fIGALLERY-ID TITLE [DESCRIPTION]\fP"
تنظیم TITLE و/یا DESCRIPTION برای یک GALLERY-ID.
.IP "\fBgalleries.editPhoto\fP \fIGALLERY-ID PHOTO-ID COMMENT\fP"
تنظیم COMMENT برای PHOTO-ID در GALLERY-ID.
.IP "\fBgalleries.editPhotos\fP \fIGALLERY-ID PRIMARY-PHOTO-ID PHOTO-IDS,...\fP"
تنظیم PHOTO-IDهای یک GALLERY-ID و PRIMARY-PHOTO-ID.
.IP "\fBgalleries.getInfo\fP \fIGALLERY-ID\fP"
دریافت اطلاعات درباره GALLERY-ID.
.IP "\fBgalleries.getList\fP \fIUSER-ID [PER-PAGE [PAGE]]\fP"
دریافت فهرست نگارخانه‌ها برای یک USER-ID با صفحه‌بندی اختیاری.
.IP "\fBgalleries.getListForPhoto\fP \fIPHOTO-ID [PER-PAGE [PAGE]]\fP"
دریافت فهرست نگارخانه‌هایی که PHOTO-ID در آن‌ها قرار دارد با صفحه‌بندی اختیاری.
.IP "\fBgalleries.getPhotos\fP \fIGALLERY-ID [EXTRAS [PER-PAGE [PAGE [FORMAT]]]]\fP"
دریافت فهرست عکس‌ها در GALLERY-ID با گزینه‌ها.
.IP "\fBgetphotoid\fP \fIIMAGE-URL\fP"
دریافت شناسه عکس از یک نشانی اینترنتی خام تصویر مزرعه فلیکر (IMAGE-URL).
.IP "\fBgroups.browse\fP \fI[CAT-ID]\fP"
مرور گروه‌های زیر دسته CAT-ID (یا ریشه).
.IP "\fBgroups.getInfo\fP \fIGROUP-ID [LANG]\fP"
دریافت اطلاعات درباره گروه GROUP-ID با زبان LANG.
.IP "\fBgroups.join\fP \fIGROUP-ID [ACCEPT-RULES]\fP"
عضویت در گروه GROUP-ID با پذیرش اختیاری قوانین.
.IP "\fBgroups.joinRequest\fP \fIGROUP-ID MESSAGE ACCEPT-RULES\fP"
درخواست عضویت در گروه GROUP-ID با استفاده از پیام MESSAGE و پذیرش قوانین.
.IP "\fBgroups.leave\fP \fIGROUP-ID [DELETE-PHOTOS]\fP"
ترک گروه GROUP-ID و حذف اختیاری عکس‌ها.
.IP "\fBgroups.members.getList\fP \fIGROUP-ID [MEMBER-TYPES [PER-PAGE [PAGE]]]\fP"
دریافت فهرست اعضا از انواع MEMBER-TYPES برای گروه GROUP-ID.
.IP "\fBgroups.pools.add\fP \fIPHOTO-ID GROUP-ID\fP"
افزودن PHOTO-ID به استخر اشتراک عکس (pool) گروه GROUP-ID.
.IP "\fBgroups.pools.getContext\fP \fIPHOTO-ID GROUP-ID\fP"
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در استخر عکس گروه GROUP-ID.
.IP "\fBgroups.pools.getGroups\fP \fI[PER-PAGE [PAGE]]\fP"
دریافت فهرست گروه‌هایی که کاربر می‌تواند به آن‌ها عکس بیفزاید.
.IP "\fBgroups.pools.getPhotos\fP \fIGROUP-ID [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌ها در GROUP-ID.
.IP "\fBgroups.pools.remove\fP \fIPHOTO-ID GROUP-ID\fP"
حذف PHOTO-ID از گروه GROUP-ID.
.IP "\fBgroups.search\fP \fITEXT [PER-PAGE [PAGE]]\fP"
جستجو برای گروه‌های منطبق با متن TEXT همراه با صفحه‌بندی PER-PAGE و PAGE.
.IP "\fBinterestingness.getList\fP \fI[PARAMS]\fP"
دریافت عکس‌های جالب‌توجه با پارامترهای اختیاری
.br
date DATE 
.br
extras EXTRAS 
.br
per-page PER-PAGE 
.br
page PAGE 
.br
format FORMAT
.IP "\fBmachinetags.getNamespaces\fP \fI[PREDICATE [PER-PAGE [PAGE]]]\fP"
دریافت فهرستی از فضاهای نام (namespaces) با PREDICATE اختیاری.
.IP "\fBmachinetags.getPairs\fP \fI[NAMESPACE [PREDICATE [PER-PAGE [PAGE]]]]\fP"
دریافت فهرستی از جفت‌های یکتای NAMESPACE و PREDICATE.
.IP "\fBmachinetags.getPredicates\fP \fI[NAMESPACE [PER-PAGE [PAGE]]]\fP"
دریافت فهرستی از گزاره‌های یکتا (predicates) به صورت اختیاری بر اساس NAMESPACE.
.IP "\fBmachinetags.getRecentValues\fP \fI[NAMESPACE|- [PREDICATE|- [ADDED-SINCE]]]\fP"
دریافت فهرستی از برچسب‌های ماشینی اخیر برای NAMESPACE و PREDICATE از تاریخ ADDED-SINCE به بعد.
.IP "\fBmachinetags.getValues\fP \fINAMESPACE PREDICATE [PER-PAGE [PAGE]]\fP"
دریافت فهرستی از مقادیر یکتا برای یک NAMESPACE و PREDICATE.
.IP "\fBoauth.create\fP \fI[CALLBACK]\fP"
ایجاد جفت کلید/رمز درخواست OAuth و نمایش نشانی وب احراز هویت.
.IP "\fBoauth.upgrade\fP \fI\fP"
ارتقای سیستم احراز هویت سنتی به OAuth.
.IP "\fBoauth.verify\fP \fIREQUEST-TOKEN REQUEST-TOKEN-SECRET VERIFIER\fP"
تایید یک درخواست OAuth ایجاد شده با `oauth.create'.
.IP "\fBpanda.getList\fP \fI\fP"
دریافت فهرست جاری پانداها (pandas).
.IP "\fBpanda.getPhotos\fP \fIPANDA\fP"
درخواست فهرستی از عکس‌های عمومی و امن اخیر از یک PANDA.
.IP "\fBpeople.findByEmail\fP \fIEMAIL\fP"
دریافت شناسه NSID کاربر از روی نشانی EMAIL او.
.IP "\fBpeople.findByUsername\fP \fIUSERNAME\fP"
دریافت شناسه NSID کاربر از روی USERNAME او.
.IP "\fBpeople.getGroups\fP \fIUSER-ID [GROUP-EXTRAS]\fP"
دریافت فهرست گروه‌هایی که USER-ID عضو آن‌ها است.
.IP "\fBpeople.getInfo\fP \fIUSER-NSID\fP"
دریافت اطلاعات درباره یک فرد با شناسه USER-NSID.
.IP "\fBpeople.getPhotos\fP \fIUSER-NSID\fP"
دریافت عکس‌های کاربر USER-NSID با پارامترهای اختیاری
.br
safe-search 1-3 
.br
min-upload-date DATE 
.br
max-upload-date DATE
.br
min-taken date DATE 
.br
max-taken-date DATE 
.br
content-type 1-7
.br
privacy-filter 1-5 
.br
per-page PER-PAGE 
.br
page PAGE 
.br
format FORMAT
.IP "\fBpeople.getPhotosOf\fP \fIUSER-NSID [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت عکس‌های عمومی از کاربر USER-NSID.
.IP "\fBpeople.getPublicGroups\fP \fIUSER-NSID\fP"
دریافت فهرست گروه‌های عمومی که کاربر در آن‌ها عضویت دارد.
.IP "\fBpeople.getPublicPhotos\fP \fIUSER-NSID [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت عکس‌های عمومی برای کاربر USER-NSID.
.IP "\fBpeople.getUploadStatus\fP \fI\fP"
دریافت وضعیت بارگذاری کاربر فراخواننده.
.IP "\fBphotos.addTags\fP \fIPHOTO-ID TAGS\fP"
افزودن برچسب‌های TAGS به عکس PHOTO-ID.
.IP "\fBphotos.comments.addComment\fP \fIPHOTO-ID TEXT\fP"
افزودن متن دیدگاه TEXT به عکس PHOTO-ID.
.IP "\fBphotos.comments.deleteComment\fP \fICOMMENT-ID\fP"
حذف دیدگاه عکس با شناسه COMMENT-ID.
.IP "\fBphotos.comments.editComment\fP \fICOMMENT-ID TEXT\fP"
ویرایش دیدگاه عکس COMMENT-ID و جایگزینی با متن جدید TEXT.
.IP "\fBphotos.comments.getList\fP \fIPHOTO-ID\fP"
دریافت دیدگاه‌های مربوط به عکس PHOTO-ID.
.IP "\fBphotos.comments.getRecentForContacts\fP \fI[PARAMS]\fP"
دریافت فهرست عکس‌های مخاطبان کاربر که اخیراً دیدگاه داشته‌اند
.br
since DATE-LAST-COMMENT filter CONTACTS-FILTER
.br
per-page PER-PAGE page PAGE format FORMAT
.IP "\fBphotos.delete\fP \fIPHOTO-ID\fP"
حذف عکس PHOTO-ID.
.IP "\fBphotos.geo.getLocation\fP \fIPHOTO-ID\fP"
دریافت موقعیت مکانی جغرافیایی برای عکس PHOTO-ID.
.IP "\fBphotos.geo.getPerms\fP \fIPHOTO-ID\fP"
دریافت مجوزهای جغرافیایی برای عکس PHOTO-ID.
.IP "\fBphotos.geo.removeLocation\fP \fIPHOTO-ID\fP"
حذف موقعیت مکانی برای عکس PHOTO-ID.
.IP "\fBphotos.geo.setLocation\fP \fIPHOTO-ID LAT LONG ACCURACY\fP"
تنظیم موقعیت مکانی برای عکس PHOTO-ID.
.IP "\fBphotos.geo.setPerms\fP \fIPHOTO-ID IS-PUBLIC IS-CONTACT IS-FRIEND IS-FAMILY\fP"
تنظیم مجوزهای جغرافیایی برای عکس PHOTO-ID.
.IP "\fBphotos.getAllContexts\fP \fIPHOTO-ID\fP"
دریافت تمامی مجموعه‌ها و استخرهای عکسی که PHOTO-ID در آن‌ها قرار دارد.
.IP "\fBphotos.getContactsPhotos\fP \fI\fP"
دریافت فهرستی از عکس‌های اخیر مخاطبان کاربر فراخواننده.
.IP "\fBphotos.getContactsPublicPhotos\fP \fIUSER-NSID [FORMAT]\fP"
دریافت فهرستی از عکس‌های عمومی اخیر مخاطبان USER-NSID.
.IP "\fBphotos.getContext\fP \fIPHOTO-ID\fP"
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در یک جریان عکس (photostream).
.IP "\fBphotos.getCounts\fP \fIDATES TAKEN-DATES\fP"
دریافت تعداد شمارش برای مجموعه‌ای از تواریخ DATES یا TAKEN-DATES.
.IP "\fBphotos.getExif\fP \fIPHOTO-ID\fP"
دریافت اطلاعات EXIF درباره یک عکس با شناسه PHOTO-ID.
.IP "\fBphotos.getFavorites\fP \fIPHOTO-ID [PER-PAGE [PAGE]]\fP"
دریافت اطلاعات برگزیده‌شدن برای یک عکس با شناسه PHOTO-ID.
.IP "\fBphotos.getInfo\fP \fIPHOTO-ID [SECRET]\fP"
دریافت اطلاعات درباره عکس PHOTO-ID به همراه کلید SECRET اختیاری.
.IP "\fBphotos.getNotInSet\fP \fI[PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌هایی که در هیچ مجموعه‌ای قرار ندارند.
.IP "\fBphotos.getPerms\fP \fIPHOTO-ID\fP"
دریافت مجوزهای مشاهده و دیدگاه‌گذاری عکس.
.IP "\fBphotos.getRecent\fP \fI[PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌های اخیر.
.IP "\fBphotos.getSizes\fP \fIPHOTO-ID\fP"
دریافت اندازه‌های مختلف موجود برای عکس PHOTO-ID.
.IP "\fBphotos.getUntagged\fP \fI[PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌هایی که برچسب‌گذاری نشده‌اند.
.IP "\fBphotos.getWithGeoData\fP \fI[PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌هایی که دارای اطلاعات مکانی (جغرافیایی) هستند.
.IP "\fBphotos.getWithoutGeoData\fP \fI[PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌هایی که اطلاعات مکانی (جغرافیایی) ندارند.
.IP "\fBphotos.licenses.getInfo\fP \fI\fP"
دریافت فهرست پروانه‌های مجاز و دردسترس عکس.
.IP "\fBphotos.licenses.setLicense\fP \fIPHOTO-ID LICENSE-ID\fP"
تنظیم پروانه عکس PHOTO-ID به LICENSE-ID.
.IP "\fBphotos.notes.add\fP \fIPHOTO-ID X Y W H TEXT\fP"
افزودن یادداشت (X, Y, W, H, TEXT) به عکسی با شناسه PHOTO-ID.
.IP "\fBphotos.notes.delete\fP \fINOTE-ID\fP"
حذف یادداشت با شناسه NOTE-ID.
.IP "\fBphotos.notes.edit\fP \fINOTE-ID X Y W H TEXT\fP"
ویرایش یادداشت NOTE-ID به مختصات و متن (X, Y, W, H, TEXT).
.IP "\fBphotos.people.add\fP \fIPHOTO-ID USER-ID X Y W H\fP"
علامت‌گذاری حضور USER-ID در عکس PHOTO-ID در مختصات (X, Y, W, H).
.IP "\fBphotos.people.delete\fP \fIPHOTO-ID USER-ID\fP"
حذف علامت‌گذاری حضور USER-ID از عکس PHOTO-ID.
.IP "\fBphotos.people.deleteCoords\fP \fIPHOTO-ID USER-ID\fP"
حذف مختصات مربوط به حضور USER-ID در عکس PHOTO-ID.
.IP "\fBphotos.people.editCoords\fP \fIPHOTO-ID USER-ID X Y W H\fP"
به‌روزرسانی مختصات حضور USER-ID در عکس PHOTO-ID به (X, Y, W, H).
.IP "\fBphotos.people.getList\fP \fIPHOTO-ID\fP"
دریافت فهرست کاربرانی که در عکس PHOTO-ID حضور دارند.
.IP "\fBphotos.recentlyUpdated\fP \fIMIN-DATE [PER-PAGE [PAGE [FORMAT]]]\fP"
دریافت فهرست عکس‌هایی که اخیراً به‌روزرسانی شده‌اند.
.IP "\fBphotos.removeTag\fP \fIPHOTO-ID TAG-ID\fP"
حذف برچسب TAG-ID از یک عکس.
.IP "\fBphotos.search\fP \fI[PARAMS] tags TAGS...\fP"
جستجو برای عکس‌ها/ویدیوها با پارامترهای اختیاری متعدد
.br
user USER 
.br
tag-mode any|all 
.br
text TEXT
.br
(min|max)-(upload|taken)-date DATE
.br
license LICENSE 
.br
privacy PRIVACY 
.br
bbox a,b,c,d
.br
sort date-(posted|taken)-(asc|desc)|interestingness-(desc|asc)|relevance
.br
accuracy 1-16 
.br
safe-search 1-3 
.br
type 1-4
.br
machine-tags TAGS 
.br
machine-tag-mode any|all
.br
group-id ID 
.br
place-id ID 
.br
extras EXTRAS
.br
per-page PER-PAGE 
.br
page PAGES
.br
media all|photos|videos 
.br
has-geo
.br
lat LAT lon LON radius RADIUS radius-units km|mi
.br
contacts (all|ff)
.br
format FORMAT 
.br
woeid WOEID
.br
geo-context 1-2
.br
in-commons 
.br
in-gallery
.IP "\fBphotos.setContentType\fP \fIPHOTO-ID TYPE\fP"
تنظیم نوع محتوای عکس TYPE به یکی از مقادیر 'photo' یا 'screenshot' یا 'other'.
.IP "\fBphotos.setDates\fP \fIPHOTO-ID POSTED TAKEN GRANULARITY\fP"
تنظیم تاریخ ارسال (POSTED) و تاریخ گرفتن (TAKEN) عکس با میزان دقت زمانی GRANULARITY.
.IP "\fBphotos.setMeta\fP \fIPHOTO-ID TITLE DESCRIPTION\fP"
تنظیم عنوان TITLE و توضیحات DESCRIPTION عکس.
.IP "\fBphotos.setPerms\fP \fIPHOTO-ID IS-PUBLIC IS-FRIEND IS-FAMILY PERM-COMMENT PERM-ADDMETA\fP"
تنظیم مجوزهای مشاهده و دیدگاه‌گذاری عکس.
.IP "\fBphotos.setSafetyLevel\fP \fIPHOTO-ID SAFETY-LEVEL HIDDEN\fP"
تنظیم سطح ایمنی SAFETY-LEVEL و پرچم پنهان‌سازی HIDDEN عکس.
.IP "\fBphotos.setTags\fP \fIPHOTO-ID TAGS\fP"
تنظیم برچسب‌های عکس PHOTO-ID به TAGS.
.IP "\fBphotos.transform.rotate\fP \fIPHOTO-ID DEGREES\fP"
چرخاندن PHOTO-ID به اندازه 90/180/270 درجه (DEGREES).
.IP "\fBphotos.upload.checkTickets\fP \fITICKET-IDS...\fP"
دریافت وضعیت بلیت‌های بارگذاری TICKET-IDS.
.IP "\fBphotosets.addPhoto\fP \fIPHOTOSET-ID PHOTO-ID\fP"
افزودن PHOTO-ID به آلبوم PHOTOSET-ID.
.IP "\fBphotosets.comments.addComment\fP \fIPHOTOSET-ID TEXT\fP"
افزودن متن دیدگاه TEXT به آلبوم PHOTOSET-ID.
.IP "\fBphotosets.comments.deleteComment\fP \fICOMMENT-ID\fP"
حذف دیدگاه آلبوم با شناسه COMMENT-ID.
.IP "\fBphotosets.comments.editComment\fP \fICOMMENT-ID TEXT\fP"
ویرایش دیدگاه آلبوم COMMENT-ID به متن جدید TEXT.
.IP "\fBphotosets.comments.getList\fP \fIPHOTOSET-ID\fP"
دریافت دیدگاه‌های یک آلبوم PHOTOSET-ID.
.IP "\fBphotosets.create\fP \fITITLE DESCRIPTION PRIMARY-PHOTO-ID\fP"
ایجاد یک آلبوم با TITLE، DESCRIPTION و PRIMARY-PHOTO-ID.
.IP "\fBphotosets.delete\fP \fIPHOTOSET-ID\fP"
حذف یک آلبوم با شناسه PHOTOSET-ID.
.IP "\fBphotosets.editMeta\fP \fIPHOTOSET-ID TITLE DESCRIPTION\fP"
تنظیم TITLE و/یا DESCRIPTION برای یک PHOTOSET-ID.
.IP "\fBphotosets.editPhotos\fP \fIPHOTOSET-ID PRIMARY-PHOTO-ID PHOTO-IDS,...\fP"
تنظیم شناسه‌های PHOTO-ID و عکس اصلی PRIMARY-PHOTO-ID برای یک PHOTOSET-ID.
.IP "\fBphotosets.getContext\fP \fIPHOTO-ID PHOTOSET-ID\fP"
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در آلبوم PHOTOSET-ID.
.IP "\fBphotosets.getInfo\fP \fIPHOTOSET-ID\fP"
دریافت اطلاعات درباره آلبوم PHOTOSET-ID.
.IP "\fBphotosets.getList\fP \fI[USER-NSID]\fP"
دریافت فهرست آلبوم‌های عکس برای کاربر USER-NSID.
.IP "\fBphotosets.getPhotos\fP \fIPHOTOSET-ID [EXTRAS [PRIVACY [PER-PAGE [PAGE [FORMAT]]]]]\fP"
دریافت فهرست عکس‌ها در آلبوم PHOTOSET-ID به همراه گزینه‌ها.
.IP "\fBphotosets.orderSets\fP \fIPHOTOSET-IDS...\fP"
تنظیم ترتیب آلبوم‌های PHOTOSET-IDS.
.IP "\fBphotosets.removePhoto\fP \fIPHOTOSET-ID PHOTO-ID\fP"
حذف عکس PHOTO-ID از آلبوم PHOTOSET-ID.
.IP "\fBphotosets.removePhotos\fP \fIPHOTOSET-ID PHOTO-IDS...\fP"
حذف چندین عکس PHOTO-IDS از آلبوم PHOTOSET-ID.
.IP "\fBphotosets.reorderPhotos\fP \fIPHOTOSET-ID PHOTO-IDS...\fP"
مرتب‌سازی مجدد PHOTO-IDS در آلبوم PHOTOSET-ID.
.IP "\fBphotosets.setPrimaryPhoto\fP \fIPHOTOSET-ID PHOTO-ID\fP"
تنظیم عکس اصلی آلبوم PHOTOSET-ID به PHOTO-ID.
.IP "\fBplaces.find\fP \fITEXT\fP"
یافتن مکان‌ها بر اساس پرس‌وجوی متنی TEXT.
.IP "\fBplaces.findByLatLon\fP \fILAT LON ACCURACY\fP"
یافتن مکان‌ها بر اساس عرض LAT و طول LON با دقت ACCURACY بین ۱ تا ۱۶.
.IP "\fBplaces.getChildrenWithPhotosPublic\fP \fIPLACE-ID|- [WOE-ID|-]\fP"
یافتن مکان‌های فرزند دارای عکس‌های عمومی با استفاده از PLACE-ID یا WOE-ID.
.IP "\fBplaces.getInfo\fP \fIPLACE-ID|- [WOE-ID|-]\fP"
یافتن مکان با استفاده از PLACE-ID یا WOE-ID.
.IP "\fBplaces.getInfoByUrl\fP \fIURL\fP"
یافتن مکان بر اساس نشانی اینترنتی مکان (URL).
.IP "\fBplaces.getPlaceTypes\fP \fIURL\fP"
دریافت فهرستی از انواع مکان‌های دردسترس.
.IP "\fBplaces.getShapeHistory\fP \fIPLACE-ID|- [WOE-ID|-]\fP"
دریافت تاریخچه شکل‌ها برای یک مکان بر پایه PLACE-ID یا WOE-ID.
.IP "\fBplaces.getTopPlacesList\fP \fIPLACE-TYPE [DATE [WOE-ID|- [PLACE-ID]]]\fP"
دریافت ۱۰۰ مکان برتر با بیشترین برچسب مکانی برای تاریخ DATE (یا روز گذشته).
.IP "\fBplaces.placesForBoundingBox\fP \fIPLACE-TYPE MIN-LONG MIN-LAT MAX-LONG MAX-LAT\fP"
یافتن مکان‌های کاربری از نوع PLACE-TYPE در محدوده کادر مرزی.
.IP "\fBplaces.placesForContacts\fP \fIPLACE-TYPE WOE-ID|- PLACE-ID|- THRESHOLD [PARAMS]\fP"
یافتن ۱۰۰ مکان یکتای برتر خوشه‌بندی‌شده بر مبنای PLACE-TYPE معین برای
.br
مخاطبان یک کاربر با پارامترهای اختیاری
.br
contacts CONTACTS 
.br
min-upload MIN-UPLOAD-DATE 
.br
max-upload MAX-UPLOAD-DATE
.br
min-taken MIN-TAKEN-DATE 
.br
max-taken MAX-TAKEN-DATE
.IP "\fBplaces.placesForUser\fP \fIPLACE-TYPE [WOE-ID] [PLACE-ID [THRESHOLD]]]\fP"
یافتن مکان‌های کاربری از نوع PLACE-TYPE.
.IP "\fBplaces.resolvePlaceId\fP \fIPLACE-ID  / WOE-ID\fP"
یافتن اطلاعات مکان‌ها بر اساس PLACE-ID یا WOE-ID (عدد).
.IP "\fBplaces.resolvePlaceURL\fP \fIPLACE-URL\fP"
یافتن اطلاعات مکان‌ها بر اساس نشانی اینترنتی PLACE-URL.
.IP "\fBplaces.tagsForPlace\fP \fIPLACE-ID|- [WOE-ID|-]\fP"
دریافت برچسب‌های یک مکان بر پایه PLACE-ID یا WOE-ID با پارامترهای اختیاری
.br
min-upload MIN-UPLOAD-DATE 
.br
max-upload MAX-UPLOAD-DATE
.br
min-taken MIN-TAKEN-DATE 
.br
max-taken MAX-TAKEN-DATE
.IP "\fBprefs.getContentType\fP \fI\fP"
دریافت ترجیح نوع محتوای پیش‌فرض کاربر.
.IP "\fBprefs.getGeoPerms\fP \fI\fP"
دریافت سطح حریم خصوصی پیش‌فرض برای اطلاعات مکانی کاربر.
.IP "\fBprefs.getHidden\fP \fI\fP"
دریافت ترجیح پیش‌فرض پنهان‌بودن برای کاربر.
.IP "\fBprefs.getPrivacy\fP \fI\fP"
دریافت ترجیح پیش‌فرض حریم خصوصی برای کاربر.
.IP "\fBprefs.getSafetyLevel\fP \fI\fP"
دریافت سطح ایمنی پیش‌فرض برای کاربر.
.IP "\fBreflection.getMethodInfo\fP \fINAME\fP"
دریافت اطلاعات درباره متد NAME در وب‌سرویس (API).
.IP "\fBreflection.getMethods\fP \fI\fP"
دریافت تمامی متدهای وب‌سرویس (API).
.IP "\fBreplace\fP \fIFILE PHOTO-ID [async]\fP"
جایگزینی عکس PHOTO-ID با یک فایل جدید FILE (به‌صورت ناهمگام یا async).
.IP "\fBshorturi\fP \fIPHOTO-ID\fP"
دریافت نشانی کوتاه http://flic.kr برای عکس PHOTO-ID.
.IP "\fBstats.getCollectionDomains\fP \fIDATE [COLLECTION-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار دامنه‌های ارجاع‌دهنده مجموعه.
.IP "\fBstats.getCollectionReferrers\fP \fIDATE DOMAIN [COLLECTION-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار ارجاع‌دهنده‌های مجموعه.
.IP "\fBstats.getCollectionStats\fP \fIDATE COLLECTION-ID\fP"
دریافت آمار تعداد بازدیدهای مجموعه.
.IP "\fBstats.getPhotoDomains\fP \fIDATE [PHOTO-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار دامنه‌های ارجاع‌دهنده عکس.
.IP "\fBstats.getPhotoReferrers\fP \fIDATE DOMAIN [PHOTO-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار ارجاع‌دهنده‌های عکس.
.IP "\fBstats.getPhotoStats\fP \fIDATE PHOTO-ID\fP"
دریافت آمار تعداد بازدیدهای عکس.
.IP "\fBstats.getPhotosetDomains\fP \fIDATE [PHOTOSET-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار دامنه‌های ارجاع‌دهنده آلبوم.
.IP "\fBstats.getPhotosetReferrers\fP \fIDATE DOMAIN [PHOTOSET-ID [PER-PAGE [PAGE]]]\fP"
دریافت آمار ارجاع‌دهنده‌های آلبوم.
.IP "\fBstats.getPhotosetStats\fP \fIDATE PHOTOSET-ID\fP"
دریافت آمار تعداد بازدیدهای آلبوم.
.IP "\fBstats.getPhotostreamDomains\fP \fIDATE [PER-PAGE [PAGE]]\fP"
دریافت آمار دامنه‌های ارجاع‌دهنده جریان عکس (photostream).
.IP "\fBstats.getPhotostreamReferrers\fP \fIDATE DOMAIN [PER-PAGE [PAGE]]\fP"
دریافت آمار ارجاع‌دهنده‌های جریان عکس (photostream).
.IP "\fBstats.getPhotostreamStats\fP \fIDATE\fP"
دریافت آمار تعداد بازدیدهای جریان عکس (photostream).
.IP "\fBstats.getPopularPhotos\fP \fI[DATE [SORT [PER-PAGE [PAGE [EXTRAS]]]]]\fP"
دریافت آمار عکس‌های پرطرفدار.
.IP "\fBstats.getTotalViews\fP \fI[DATE]\fP"
دریافت آمار کل بازدیدها.
.IP "\fBtags.getClusters\fP \fITAG\fP"
دریافت فهرست خوشه‌های برچسب برای TAG.
.IP "\fBtags.getHotList\fP \fI[PERIOD [COUNT]]\fP"
دریافت فهرست برچسب‌های داغ برای بازه زمانی PERIOD (روز یا هفته).
.IP "\fBtags.getListPhoto\fP \fIPHOTO-ID\fP"
دریافت فهرست برچسب‌های مربوط به عکس PHOTO-ID.
.IP "\fBtags.getListUser\fP \fI[USER-NSID]\fP"
دریافت فهرست برچسب‌ها برای یک کاربر USER-NSID (یا کاربر جاری).
.IP "\fBtags.getListUserPopular\fP \fI[USER-NSID [COUNT]]\fP"
دریافت فهرست برچسب‌های پرطرفدار برای یک کاربر USER-NSID (یا کاربر جاری).
.IP "\fBtags.getListUserRaw\fP \fI[TAG]\fP"
دریافت نگارش‌های خام برچسب TAG (یا تمام برچسب‌ها) برای کاربر جاری.
.IP "\fBtags.getMostFrequentlyUsed\fP \fI\fP"
دریافت پرتکرارترین برچسب‌های استفاده‌شده برای کاربر جاری.
.IP "\fBtags.getRelated\fP \fITAG\fP"
دریافت فهرستی از برچسب‌های مرتبط با TAG بر اساس تحلیل استفاده خوشه‌ای.
.IP "\fBtest.echo\fP \fIKEY VALUE\fP"
آزمایش فراخوانی پژواک در API؛ مقدار KEY VALUE را بازمی‌گرداند.
.IP "\fBtest.login\fP \fI\fP"
آزمایش فراخوانی ورود در API؛ نام کاربری را بازمی‌گرداند.
.IP "\fBtest.null\fP \fIKEY VALUE\fP"
آزمایش فراخوانی تهی در API؛ مقداری برنمی‌گرداند.
.IP "\fBupload\fP \fIFILE [PARAMS...]\fP"
بارگذاری یک فایل عکس FILE همراه با پارامترهای اختیاری PARAM یا PARAM VALUE
.br
title TITLE
.br
description DESC
.br
safety_level 'safe' (پیش‌فرض) یا 'moderate' یا 'restricted'
.br
content_type 'photo' (پیش‌فرض) یا 'screenshot' یا 'other'
.br
hidden 'public' (پیش‌فرض) یا 'hidden'
.br
friend
.br
public
.br
family
.br
tags TAGS... [باید آخرین پارامتر باشد]
.IP "\fBurls.getGroup\fP \fIGROUP-ID\fP"
دریافت نشانی اینترنتی صفحه گروه برای GROUP-ID.
.IP "\fBurls.getUserPhotos\fP \fIUSER-NSID\fP"
دریافت نشانی اینترنتی صفحه عکس‌ها برای USER-NSID.
.IP "\fBurls.getUserProfile\fP \fIUSER-NSID\fP"
دریافت نشانی اینترنتی صفحه نمایه (پروفایل) برای USER-NSID.
.IP "\fBurls.lookupGroup\fP \fIURL\fP"
دریافت شناسه NSID گروه از روی نشانی اینترنتی به صفحه گروه یا استخر عکس آن.
.IP "\fBurls.lookupUser\fP \fIURL\fP"
دریافت شناسه NSID کاربر از روی نشانی اینترنتی عکس کاربر.
.SH "فیلدهای اضافی (EXTRAS FIELDS)"
پارامتر \fBEXTRAS\fP می‌تواند مجموعه‌ای از مقادیر زیر را به‌صورت جداشده با کاما دریافت کند:
.TP
.B date_taken
تاریخ گرفته‌شدن آیتم
.TP
.B date_upload
تاریخ بارگذاری آیتم
.TP
.B geo
عرض جغرافیایی، طول جغرافیایی و دقت برچسب‌گذاری مکانی (Geotagging)
.TP
.B icon_server
فیلدهای آیکون مالک آیتم
.TP
.B last_update
تاریخ آخرین به‌روزرسانی آیتم
.TP
.B license
پروانه آیتم
.TP
.B machine_tags
برچسب‌های ماشینی
.TP
.B media
قالب آیتم: عکس (photo) یا ویدیو (video)
.TP
.B o_dims
ابعاد اصلی آیتم
.TP
.B original_format
قالب و secret اصلی آیتم
.TP
.B owner_name
شناسه مالک آیتم
.TP
.B path_alias
نام مستعار مسیر برای مالک مانند photos/USERNAME
.TP
.B tags
برچسب‌های تمیز آیتم (امن برای HTML و URLها)
.TP
.B url_c
نشانی اینترنتی تصویر اندازه متوسط ۸۰۰، ۸۰۰ پیکسل در بزرگ‌ترین ضلع
.TP
.B url_m
نشانی اینترنتی تصویر اندازه کوچک، متوسط
.TP
.B url_n
نشانی اینترنتی تصویر اندازه کوچک، ۳۲۰ پیکسل در بزرگ‌ترین ضلع
.TP
.B url_o
نشانی اینترنتی تصویر با اندازه اصلی
.TP
.B url_q
نشانی اینترنتی تصویر با اندازه مربعی بزرگ ۱۵۰x۱۵۰
.TP
.B url_s
نشانی اینترنتی تصویر با اندازه مربعی کوچک ۷۵x۷۵
.TP
.B url_sq
نشانی اینترنتی تصویر با اندازه مربعی
.TP
.B url_t
نشانی اینترنتی تصویر بندانگشتی، ۱۰۰ پیکسل در بزرگ‌ترین ضلع
.TP
.B views
تعداد دفعاتی که آیتم دیده شده است
.SH "قالب‌های فید فهرست عکس‌ها (PHOTOS LIST FEED FORMATS)"
پارامتر \fBFORMAT\fP می‌تواند هر یک از مقادیر زیر را دریافت کند:
.TP
.B feed\-rss_100
قالب RSS 1.0
.TP
.B feed\-rss_200
قالب RSS 2.0
.TP
.B feed\-atom_10
قالب Atom 1.0
.TP
.B feed\-georss
قالب RSS 2.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
.TP
.B feed\-geoatom
قالب Atom 1.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
.TP
.B feed\-geordf
قالب RSS 1.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
.TP
.B feed\-kml
قالب KML 2.1
.TP
.B feed\-kml_nl
پیوند شبکه KML 2.1
.SH "همچنین ببینید (SEE ALSO)"
.BR flickrdf (1).
.br
.SH "نویسنده (AUTHOR)"
برنامه flickcurl توسط David Beckett نوشته شده است.
.PP
این صفحه راهنما توسط Kumar Appaiah <akumar@ee.iitm.ac.in> برای پروژه دبیان نوشته شده است (اما دیگران نیز می‌توانند از آن استفاده کنند).