Panduan Pengembang
Flickr: API

Memulai

Untuk mulai menggunakan API Flickr:

  1. Minta kunci API, untuk menandatangani permintaan API Anda.
  2. Baca Pedoman Komunitas dan Ketentuan Penggunaan API.
  3. Buat, buat, buat. Uji, uji, uji.
  4. Luncurkan (dan jika aplikasi tersebut untuk komunitas Flickr, buatlah profil untuk aplikasi Anda di App Garden Flickr).

Hal-hal yang Perlu Anda Ketahui

API

  • Dokumentasi: Ini adalah dokumentasi untuk seluruh API Flickr. Di sini Anda dapat mencari semua metode dan feed yang ada, plus rincian kit API.
  • Autentikasi: Alur autentikasi Flickr didesain untuk memastikan account pengguna kami aman. Kami mengharuskan pengguna membuka Flickr untuk mengautentikasi aplikasi pihak ke-3 (seperti Anda), alih-alih mengizinkan pihak ketiga yang kemungkinan berbahaya untuk menangani nama pengguna/kata sandi. Kami tidak menerima pengecualian. Pendekatan ini mendukung semua perilaku aplikasi, dari situs web, hingga program seluler, dan set-top boxes. Baca dengan saksama dokumentasi untuk memilih alur yang paling sesuai dengan integrasi Anda.
  • Batasan: Karena API Flickr cukup mudah digunakan, API Flickr pun cukup mudah disalahgunakan, yang mengancam semua layanan yang mengandalkan API Flickr. Untuk mencegah ini, kami membatasi akses ke API per kunci. Jika aplikasi Anda tetap di bawah 3600 kueri per detik di seluruh kunci (yang artinya akumulasi dari semua pengguna integrasi Anda), maka Anda tidak ada masalah. Jika kami mendeteksi penyalahgunaan pada kunci Anda, kami akan menghentikan kunci, atau mematikannya, untuk mempertahankan fungsi API Flickr bagi lainnya (termasuk kami!). Kami juga melacak penggunaan menurut faktor lain, sekaligus memastikan bahwa tidak ada pengguna API yang menyalahgunakan sistem.
  • Keamanan Data: Jangan menyimpan semua data pengguna, seperti token otorisasi, di tempat yang mudah diketahui. Jika dilakukan, hacker (peretas) akan memanfaatkannya untuk mengakses banyak account sekaligus.
  • Mengoptimalkan kueri API: Mencari dan melokalkan panggilan memerlukan siklus CPU yang lebih tinggi daripada mencari data sederhana, sehingga memerlukan waktu lebih lama untuk melakukannya. Selain itu, hati-hatilah dengan adanya parameter "ekstra" pada kueri API yang dapat membantu mengurangi jumlah panggilan yang perlu dilakukan. Untuk tips, lihat blog Code kami, seperti postingan mengenai Respons Foto Standar ini.
  • Privasi: Setiap pengguna memiliki pengaturan privasi default untuk foto yang di-upload ke accountnya. Hargai pengaturan default ini dengan meng-upload menggunakan pengaturan ini atau menyajikannya sebagai opsi yang telah dipilih sebelumnya dalam daftar opsi privasi lainnya. Anda bisa mendapatkan pengaturan default melalui panggilan API flickr.prefs.getPrivacy, dan harap periksa pengaturan default ini setiap hari jika pengguna telah mengubahnya. Jika proyek Anda menampilkan opsi privasi untuk dipilih oleh pengguna, harap gunakan istilah standar Flickr: Publik, Teman, Keluarga, Teman dan Keluarga, Pribadi.
  • Caching jangka pendek: Aplikasi Anda dapat menyimpan sementara hasil API dan gambar selama 24 jam untuk membantu mengurangi beban API.
  • Membatalkan kunci API: Kami membatalkan kunci bagi integrasi yang melanggar Ketentuan Penggunaan API dan Pedoman Komunitas kami. Jadi pastikan bahwa Anda sudah membacanya dengan saksama.
  • Menggunakan url singkat "flic.kr": Jika Anda ingin menggunakan url singkat untuk foto tertentu, Anda dapat menggunakan penyingkat url flic.kr. Formatnya adalah: flic.kr/p/[short-photo-id] di mana id foto pendek adalah konversi base58 dari id foto. Anda dapat menemukan info selengkapnya dan contoh kode pada postingan ini di Grup API Flickr.
  • Meminta kunci: Anda dapat meminta kunci API di sini. Kami tidak dapat mengubah account mana yang menangani kunci, jadi pastikan Anda tidak meminta kunci menggunakan account pribadi pengembang, karena jika pengembang tersebut tidak ada, kunci API Flickr Anda akan lebih sulit dikendalikan.

Praktik Terbaik

  • Biarkan pengguna mengetahui apa yang terjadi ketika Anda berinteraksi atau memodifikasi fotonya. Contohnya, Anda harus membiarkan pengguna mengetahui apakah Anda menambahkan tag ke gambar yang di-upload.
  • Mengekstrak flickr.com tidaklah baik. API adalah tindakan yang dapat dilakukan untuk mendapatkan data ini, dan kami pun memblokir pengekstrak secara rutin.
  • Fotografer meng-upload fotonya dengan aspek rasio tertentu. Hargailah ukuran foto tersebut. Thumbnail bujur sangkar adalah pengecualian untuk memungkinkan browsing.
  • Ketika me-link ke Flickr, link-kan kembali ke halaman foto dan bukan ke url host yang berisi istilah "farm" yang tidak menyediakan konteks atau metadata apa pun di seluruh foto.

Sumber Daya

Kami tidak menyediakan dukungan teknis untuk API Flickr. Namun, berikut beberapa sumber daya jika Anda memiliki pertanyaan atau mengalami masalah:

Kreasi Menarik

  • App Garden: Flickr memiliki App Garden untuk menampilkan aplikasi yang dibuat dengan API Flickr. Isi halaman profil agar kunci API aplikasi Anda disertakan, terutama jika Anda memiliki uploader, karena akan ditampilkan di halaman foto sebagai sumber uploader. FAQ.
  • Blog Flickr: blog.flickr.net adalah tempat mem-posting pengumuman dan berbagi foto keren..
  • Twitter: twitter.com/flickr adalah tempat kami berbagi pengumuman cepat dengan link ke blog kami. Ini adalah account khusus pengumuman dan tidak dipantau, jadi hubungi kami langsung melalui situs kami jika Anda memiliki pertanyaan atau komentar.
  • API explorer: Di bagian bawah halaman API yang menjelaskan metode, kami memiliki alat yang disebut API Explorer, tempat Anda mempertimbangkan argumen metode dan melihat hasilnya. Berikut contohnya: flickr.photos.getInfo
  • Statistik Penggunaan API: Lihat statistik yang jelas tentang penggunaan API Flickr Anda dilengkapi grafik utilisasi yang ringkas dengan membuka halaman statistik kunci aplikasi Anda. Anda dapat menemukan halaman statistik dengan membuka Aplikasi Oleh Anda dan mengklik link "statistik" di sebelah masing-masing aplikasi.