FLICKCURL(1) General Commands Manual FLICKCURL(1)

flickcurl - ابزار خط فرمان فراخوانی وب‌سرویس‌های فلیکر (Flickr)

flickcurl -a FROB
flickcurl [-d DELAY] [-h] [-o FILE] [-q] [-v] [-V] [دستورات] ...

flickcurl ابزاری کاربردی برای فراخوانی APIهای فلیکر (Flickr) از طریق کتابخانه flickcurl است. برای دریافت فهرستی از دستورات پشتیبانی‌شده و آرگومان‌های آن‌ها، دستور flickcurl -h را اجرا کنید.

این برنامه پیش از استفاده و برای کار با APIهای فلیکر نیاز به پیکربندی دارد. دستور flickcurl را بدون هیچ گزینه‌ای اجرا کنید تا دستورالعمل‌های ثبت برنامه و ایجاد فایل پیکربندی اولیه ~/.flickcurl.conf از اطلاعات ثبت‌نام نمایش داده شود.

این برنامه‌ها از ساختار معمول خط فرمان گنو پیروی می‌کنند که در آن گزینه‌های طولانی با دو خط تیره (`-') آغاز می‌شوند. خلاصه‌ای از گزینه‌ها در زیر آمده است:

احراز هویت با یک FROB و به‌روزرسانی فایل احراز هویت. برنامه پس از به‌روزرسانی فایل خارج خواهد شد.
تنظیم تاخیر میان درخواست‌ها به میزان DELAY میلی‌ثانیه.
نمایش چکیده گزینه‌ها و خروج.
نوشتن نتایج فراخوانی‌های API فید قالب‌بندی‌شده در FILE.
نمایش اطلاعات کمتر هنگام اجرای برنامه.
نمایش نسخه برنامه و خروج.
نمایش اطلاعات بیشتر و با جزئیات هنگام اجرای برنامه.

در فهرست دستورات زیر:
PER-PAGE تعداد عکس‌ها در هر صفحه نتایج است، یا '-' برای مقدار پیش‌فرض (۱۰)
PAGE شماره صفحه نتایج است، یا '-' برای مقدار پیش‌فرض (۱ = نخستین صفحه)

دریافت عکس‌هایی که توسط فراخواننده روی آن‌ها دیدگاه گذاشته شده است.
دریافت فعالیت‌های اخیر روی عکس‌های کاربر فراخواننده.
دریافت اطلاعات هویتی متصل به یک نشانه (TOKEN) احراز هویت.
دریافت یک frob جهت استفاده در فرآیند احراز هویت.
دریافت نشانه کامل احراز هویت برای MINI-TOKEN.
دریافت نشانه احراز هویت برای FROB، در صورتی که متصل شده باشد.
دریافت فهرستی از وبلاگ‌های پیکربندی‌شده برای کاربر فراخواننده.
دریافت فهرستی از سرویس‌های وبلاگ.
ارسال PHOTO-ID به وبلاگ BLOG-ID همراه با TITLE، DESCRIPTION و گذرواژه اختیاری.
دریافت اطلاعات درباره مجموعه COLLECTION-ID.
دریافت درخت مجموعه‌های COLLECTION-ID برای USER-ID.
دریافت فهرست موسسات.
دریافت فهرستی از مخاطبان با FILTER اختیاری.
دریافت فهرستی از مخاطبانی که اخیراً از تاریخ DATE-LAST-UPLOAD بارگذاری کرده‌اند همراه با FILTER اختیاری.
دریافت فهرست مخاطبان عمومی برای کاربر USER-NSID.
دریافت پیشنهادهای برچسب‌گذاری.
افزودن PHOTO-ID به علاقه‌مندی‌های کاربر جاری.
دریافت عکس‌های پیرامون عکس برگزیده PHOTO-ID متعلق به USER-ID.
دریافت فهرستی از عکس‌های برگزیده USER-NSID.
دریافت فهرستی از عکس‌های برگزیده عمومی USER-NSID.
حذف PHOTO-ID از علاقه‌مندی‌های کاربر جاری.
افزودن عکس PHOTO-ID به نگارخانه GALLERY-ID به همراه متن TEXT.
ایجاد یک نگارخانه جدید با TITLE، DESCRIPTION و PRIMARY-PHOTO_ID.
تنظیم TITLE و/یا DESCRIPTION برای یک GALLERY-ID.
تنظیم COMMENT برای PHOTO-ID در GALLERY-ID.
تنظیم PHOTO-IDهای یک GALLERY-ID و PRIMARY-PHOTO-ID.
دریافت اطلاعات درباره GALLERY-ID.
دریافت فهرست نگارخانه‌ها برای یک USER-ID با صفحه‌بندی اختیاری.
دریافت فهرست نگارخانه‌هایی که PHOTO-ID در آن‌ها قرار دارد با صفحه‌بندی اختیاری.
دریافت فهرست عکس‌ها در GALLERY-ID با گزینه‌ها.
دریافت شناسه عکس از یک نشانی اینترنتی خام تصویر مزرعه فلیکر (IMAGE-URL).
مرور گروه‌های زیر دسته CAT-ID (یا ریشه).
دریافت اطلاعات درباره گروه GROUP-ID با زبان LANG.
عضویت در گروه GROUP-ID با پذیرش اختیاری قوانین.
درخواست عضویت در گروه GROUP-ID با استفاده از پیام MESSAGE و پذیرش قوانین.
ترک گروه GROUP-ID و حذف اختیاری عکس‌ها.
دریافت فهرست اعضا از انواع MEMBER-TYPES برای گروه GROUP-ID.
افزودن PHOTO-ID به استخر اشتراک عکس (pool) گروه GROUP-ID.
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در استخر عکس گروه GROUP-ID.
دریافت فهرست گروه‌هایی که کاربر می‌تواند به آن‌ها عکس بیفزاید.
دریافت فهرست عکس‌ها در GROUP-ID.
حذف PHOTO-ID از گروه GROUP-ID.
جستجو برای گروه‌های منطبق با متن TEXT همراه با صفحه‌بندی PER-PAGE و PAGE.
دریافت عکس‌های جالب‌توجه با پارامترهای اختیاری
date DATE
extras EXTRAS
per-page PER-PAGE
page PAGE
format FORMAT
دریافت فهرستی از فضاهای نام (namespaces) با PREDICATE اختیاری.
دریافت فهرستی از جفت‌های یکتای NAMESPACE و PREDICATE.
دریافت فهرستی از گزاره‌های یکتا (predicates) به صورت اختیاری بر اساس NAMESPACE.
دریافت فهرستی از برچسب‌های ماشینی اخیر برای NAMESPACE و PREDICATE از تاریخ ADDED-SINCE به بعد.
دریافت فهرستی از مقادیر یکتا برای یک NAMESPACE و PREDICATE.
ایجاد جفت کلید/رمز درخواست OAuth و نمایش نشانی وب احراز هویت.
ارتقای سیستم احراز هویت سنتی به OAuth.
تایید یک درخواست OAuth ایجاد شده با `oauth.create'.
دریافت فهرست جاری پانداها (pandas).
درخواست فهرستی از عکس‌های عمومی و امن اخیر از یک PANDA.
دریافت شناسه NSID کاربر از روی نشانی EMAIL او.
دریافت شناسه NSID کاربر از روی USERNAME او.
دریافت فهرست گروه‌هایی که USER-ID عضو آن‌ها است.
دریافت اطلاعات درباره یک فرد با شناسه USER-NSID.
دریافت عکس‌های کاربر USER-NSID با پارامترهای اختیاری
safe-search 1-3
min-upload-date DATE
max-upload-date DATE
min-taken date DATE
max-taken-date DATE
content-type 1-7
privacy-filter 1-5
per-page PER-PAGE
page PAGE
format FORMAT
دریافت عکس‌های عمومی از کاربر USER-NSID.
دریافت فهرست گروه‌های عمومی که کاربر در آن‌ها عضویت دارد.
دریافت عکس‌های عمومی برای کاربر USER-NSID.
دریافت وضعیت بارگذاری کاربر فراخواننده.
افزودن برچسب‌های TAGS به عکس PHOTO-ID.
افزودن متن دیدگاه TEXT به عکس PHOTO-ID.
حذف دیدگاه عکس با شناسه COMMENT-ID.
ویرایش دیدگاه عکس COMMENT-ID و جایگزینی با متن جدید TEXT.
دریافت دیدگاه‌های مربوط به عکس PHOTO-ID.
دریافت فهرست عکس‌های مخاطبان کاربر که اخیراً دیدگاه داشته‌اند
since DATE-LAST-COMMENT filter CONTACTS-FILTER
per-page PER-PAGE page PAGE format FORMAT
حذف عکس PHOTO-ID.
دریافت موقعیت مکانی جغرافیایی برای عکس PHOTO-ID.
دریافت مجوزهای جغرافیایی برای عکس PHOTO-ID.
حذف موقعیت مکانی برای عکس PHOTO-ID.
تنظیم موقعیت مکانی برای عکس PHOTO-ID.
تنظیم مجوزهای جغرافیایی برای عکس PHOTO-ID.
دریافت تمامی مجموعه‌ها و استخرهای عکسی که PHOTO-ID در آن‌ها قرار دارد.
دریافت فهرستی از عکس‌های اخیر مخاطبان کاربر فراخواننده.
دریافت فهرستی از عکس‌های عمومی اخیر مخاطبان USER-NSID.
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در یک جریان عکس (photostream).
دریافت تعداد شمارش برای مجموعه‌ای از تواریخ DATES یا TAKEN-DATES.
دریافت اطلاعات EXIF درباره یک عکس با شناسه PHOTO-ID.
دریافت اطلاعات برگزیده‌شدن برای یک عکس با شناسه PHOTO-ID.
دریافت اطلاعات درباره عکس PHOTO-ID به همراه کلید SECRET اختیاری.
دریافت فهرست عکس‌هایی که در هیچ مجموعه‌ای قرار ندارند.
دریافت مجوزهای مشاهده و دیدگاه‌گذاری عکس.
دریافت فهرست عکس‌های اخیر.
دریافت اندازه‌های مختلف موجود برای عکس PHOTO-ID.
دریافت فهرست عکس‌هایی که برچسب‌گذاری نشده‌اند.
دریافت فهرست عکس‌هایی که دارای اطلاعات مکانی (جغرافیایی) هستند.
دریافت فهرست عکس‌هایی که اطلاعات مکانی (جغرافیایی) ندارند.
دریافت فهرست پروانه‌های مجاز و دردسترس عکس.
تنظیم پروانه عکس PHOTO-ID به LICENSE-ID.
افزودن یادداشت (X, Y, W, H, TEXT) به عکسی با شناسه PHOTO-ID.
حذف یادداشت با شناسه NOTE-ID.
ویرایش یادداشت NOTE-ID به مختصات و متن (X, Y, W, H, TEXT).
علامت‌گذاری حضور USER-ID در عکس PHOTO-ID در مختصات (X, Y, W, H).
حذف علامت‌گذاری حضور USER-ID از عکس PHOTO-ID.
حذف مختصات مربوط به حضور USER-ID در عکس PHOTO-ID.
به‌روزرسانی مختصات حضور USER-ID در عکس PHOTO-ID به (X, Y, W, H).
دریافت فهرست کاربرانی که در عکس PHOTO-ID حضور دارند.
دریافت فهرست عکس‌هایی که اخیراً به‌روزرسانی شده‌اند.
حذف برچسب TAG-ID از یک عکس.
جستجو برای عکس‌ها/ویدیوها با پارامترهای اختیاری متعدد
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
woeid WOEID
geo-context 1-2
in-commons
in-gallery
تنظیم نوع محتوای عکس TYPE به یکی از مقادیر 'photo' یا 'screenshot' یا 'other'.
تنظیم تاریخ ارسال (POSTED) و تاریخ گرفتن (TAKEN) عکس با میزان دقت زمانی GRANULARITY.
تنظیم عنوان TITLE و توضیحات DESCRIPTION عکس.
تنظیم مجوزهای مشاهده و دیدگاه‌گذاری عکس.
تنظیم سطح ایمنی SAFETY-LEVEL و پرچم پنهان‌سازی HIDDEN عکس.
تنظیم برچسب‌های عکس PHOTO-ID به TAGS.
چرخاندن PHOTO-ID به اندازه 90/180/270 درجه (DEGREES).
دریافت وضعیت بلیت‌های بارگذاری TICKET-IDS.
افزودن PHOTO-ID به آلبوم PHOTOSET-ID.
افزودن متن دیدگاه TEXT به آلبوم PHOTOSET-ID.
حذف دیدگاه آلبوم با شناسه COMMENT-ID.
ویرایش دیدگاه آلبوم COMMENT-ID به متن جدید TEXT.
دریافت دیدگاه‌های یک آلبوم PHOTOSET-ID.
ایجاد یک آلبوم با TITLE، DESCRIPTION و PRIMARY-PHOTO-ID.
حذف یک آلبوم با شناسه PHOTOSET-ID.
تنظیم TITLE و/یا DESCRIPTION برای یک PHOTOSET-ID.
تنظیم شناسه‌های PHOTO-ID و عکس اصلی PRIMARY-PHOTO-ID برای یک PHOTOSET-ID.
دریافت عکس‌های بعدی و قبلی برای PHOTO-ID در آلبوم PHOTOSET-ID.
دریافت اطلاعات درباره آلبوم PHOTOSET-ID.
دریافت فهرست آلبوم‌های عکس برای کاربر USER-NSID.
دریافت فهرست عکس‌ها در آلبوم PHOTOSET-ID به همراه گزینه‌ها.
تنظیم ترتیب آلبوم‌های PHOTOSET-IDS.
حذف عکس PHOTO-ID از آلبوم PHOTOSET-ID.
حذف چندین عکس PHOTO-IDS از آلبوم PHOTOSET-ID.
مرتب‌سازی مجدد PHOTO-IDS در آلبوم PHOTOSET-ID.
تنظیم عکس اصلی آلبوم PHOTOSET-ID به PHOTO-ID.
یافتن مکان‌ها بر اساس پرس‌وجوی متنی TEXT.
یافتن مکان‌ها بر اساس عرض LAT و طول LON با دقت ACCURACY بین ۱ تا ۱۶.
یافتن مکان‌های فرزند دارای عکس‌های عمومی با استفاده از PLACE-ID یا WOE-ID.
یافتن مکان با استفاده از PLACE-ID یا WOE-ID.
یافتن مکان بر اساس نشانی اینترنتی مکان (URL).
دریافت فهرستی از انواع مکان‌های دردسترس.
دریافت تاریخچه شکل‌ها برای یک مکان بر پایه PLACE-ID یا WOE-ID.
دریافت ۱۰۰ مکان برتر با بیشترین برچسب مکانی برای تاریخ DATE (یا روز گذشته).
یافتن مکان‌های کاربری از نوع PLACE-TYPE در محدوده کادر مرزی.
یافتن ۱۰۰ مکان یکتای برتر خوشه‌بندی‌شده بر مبنای PLACE-TYPE معین برای
مخاطبان یک کاربر با پارامترهای اختیاری
contacts CONTACTS
min-upload MIN-UPLOAD-DATE
max-upload MAX-UPLOAD-DATE
min-taken MIN-TAKEN-DATE
max-taken MAX-TAKEN-DATE
یافتن مکان‌های کاربری از نوع PLACE-TYPE.
یافتن اطلاعات مکان‌ها بر اساس PLACE-ID یا WOE-ID (عدد).
یافتن اطلاعات مکان‌ها بر اساس نشانی اینترنتی PLACE-URL.
دریافت برچسب‌های یک مکان بر پایه PLACE-ID یا WOE-ID با پارامترهای اختیاری
min-upload MIN-UPLOAD-DATE
max-upload MAX-UPLOAD-DATE
min-taken MIN-TAKEN-DATE
max-taken MAX-TAKEN-DATE
دریافت ترجیح نوع محتوای پیش‌فرض کاربر.
دریافت سطح حریم خصوصی پیش‌فرض برای اطلاعات مکانی کاربر.
دریافت ترجیح پیش‌فرض پنهان‌بودن برای کاربر.
دریافت ترجیح پیش‌فرض حریم خصوصی برای کاربر.
دریافت سطح ایمنی پیش‌فرض برای کاربر.
دریافت اطلاعات درباره متد NAME در وب‌سرویس (API).
دریافت تمامی متدهای وب‌سرویس (API).
جایگزینی عکس PHOTO-ID با یک فایل جدید FILE (به‌صورت ناهمگام یا async).
دریافت نشانی کوتاه http://flic.kr برای عکس PHOTO-ID.
دریافت آمار دامنه‌های ارجاع‌دهنده مجموعه.
دریافت آمار ارجاع‌دهنده‌های مجموعه.
دریافت آمار تعداد بازدیدهای مجموعه.
دریافت آمار دامنه‌های ارجاع‌دهنده عکس.
دریافت آمار ارجاع‌دهنده‌های عکس.
دریافت آمار تعداد بازدیدهای عکس.
دریافت آمار دامنه‌های ارجاع‌دهنده آلبوم.
دریافت آمار ارجاع‌دهنده‌های آلبوم.
دریافت آمار تعداد بازدیدهای آلبوم.
دریافت آمار دامنه‌های ارجاع‌دهنده جریان عکس (photostream).
دریافت آمار ارجاع‌دهنده‌های جریان عکس (photostream).
دریافت آمار تعداد بازدیدهای جریان عکس (photostream).
دریافت آمار عکس‌های پرطرفدار.
دریافت آمار کل بازدیدها.
دریافت فهرست خوشه‌های برچسب برای TAG.
دریافت فهرست برچسب‌های داغ برای بازه زمانی PERIOD (روز یا هفته).
دریافت فهرست برچسب‌های مربوط به عکس PHOTO-ID.
دریافت فهرست برچسب‌ها برای یک کاربر USER-NSID (یا کاربر جاری).
دریافت فهرست برچسب‌های پرطرفدار برای یک کاربر USER-NSID (یا کاربر جاری).
دریافت نگارش‌های خام برچسب TAG (یا تمام برچسب‌ها) برای کاربر جاری.
دریافت پرتکرارترین برچسب‌های استفاده‌شده برای کاربر جاری.
دریافت فهرستی از برچسب‌های مرتبط با TAG بر اساس تحلیل استفاده خوشه‌ای.
آزمایش فراخوانی پژواک در API؛ مقدار KEY VALUE را بازمی‌گرداند.
آزمایش فراخوانی ورود در API؛ نام کاربری را بازمی‌گرداند.
آزمایش فراخوانی تهی در API؛ مقداری برنمی‌گرداند.
بارگذاری یک فایل عکس FILE همراه با پارامترهای اختیاری PARAM یا PARAM VALUE
title TITLE
description DESC
safety_level 'safe' (پیش‌فرض) یا 'moderate' یا 'restricted'
content_type 'photo' (پیش‌فرض) یا 'screenshot' یا 'other'
hidden 'public' (پیش‌فرض) یا 'hidden'
friend
public
family
tags TAGS... [باید آخرین پارامتر باشد]
دریافت نشانی اینترنتی صفحه گروه برای GROUP-ID.
دریافت نشانی اینترنتی صفحه عکس‌ها برای USER-NSID.
دریافت نشانی اینترنتی صفحه نمایه (پروفایل) برای USER-NSID.
دریافت شناسه NSID گروه از روی نشانی اینترنتی به صفحه گروه یا استخر عکس آن.
دریافت شناسه NSID کاربر از روی نشانی اینترنتی عکس کاربر.

پارامتر EXTRAS می‌تواند مجموعه‌ای از مقادیر زیر را به‌صورت جداشده با کاما دریافت کند:

تاریخ گرفته‌شدن آیتم
تاریخ بارگذاری آیتم
عرض جغرافیایی، طول جغرافیایی و دقت برچسب‌گذاری مکانی (Geotagging)
فیلدهای آیکون مالک آیتم
تاریخ آخرین به‌روزرسانی آیتم
پروانه آیتم
برچسب‌های ماشینی
قالب آیتم: عکس (photo) یا ویدیو (video)
ابعاد اصلی آیتم
قالب و secret اصلی آیتم
شناسه مالک آیتم
نام مستعار مسیر برای مالک مانند photos/USERNAME
برچسب‌های تمیز آیتم (امن برای HTML و URLها)
نشانی اینترنتی تصویر اندازه متوسط ۸۰۰، ۸۰۰ پیکسل در بزرگ‌ترین ضلع
نشانی اینترنتی تصویر اندازه کوچک، متوسط
نشانی اینترنتی تصویر اندازه کوچک، ۳۲۰ پیکسل در بزرگ‌ترین ضلع
نشانی اینترنتی تصویر با اندازه اصلی
نشانی اینترنتی تصویر با اندازه مربعی بزرگ ۱۵۰x۱۵۰
نشانی اینترنتی تصویر با اندازه مربعی کوچک ۷۵x۷۵
نشانی اینترنتی تصویر با اندازه مربعی
نشانی اینترنتی تصویر بندانگشتی، ۱۰۰ پیکسل در بزرگ‌ترین ضلع
تعداد دفعاتی که آیتم دیده شده است

پارامتر FORMAT می‌تواند هر یک از مقادیر زیر را دریافت کند:

قالب RSS 1.0
قالب RSS 2.0
قالب Atom 1.0
قالب RSS 2.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
قالب Atom 1.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
قالب RSS 1.0 به همراه GeoRSS و W3C Geo برای عکس‌های دارای برچسب مکانی
قالب KML 2.1
پیوند شبکه KML 2.1

flickrdf(1).

برنامه flickcurl توسط David Beckett نوشته شده است.

این صفحه راهنما توسط Kumar Appaiah <akumar@ee.iitm.ac.in> برای پروژه دبیان نوشته شده است (اما دیگران نیز می‌توانند از آن استفاده کنند).

1 September 2008