Flickraw 使用与技术文档

本文档将详细介绍如何安装、使用Flickraw库，以及如何通过其API访问Flickr API。

1. 安装指南

首先，确保您的系统已经安装了Ruby环境。接下来，通过以下命令安装Flickraw：

gem install json # 在ruby 1.8中是必需的
gem install flickraw

安装完成后，可以生成文档：

cd flickraw
rake rdoc

2. 项目使用说明

Flickraw是一个Ruby库，用于以简单的方式访问Flickr API。它完全映射了官方API文档中描述的方法，并以直观的方式展示返回的数据。

获取开始

使用FlickRaw之前，您需要从Flickr获取API密钥和共享密钥。您可以通过登录Flickr并在此处创建应用来获取这些凭据：Flickr 应用创建。

require 'flickraw'

# 提供API密钥和共享密钥
flickr = FlickRaw::Flickr.new "您的API密钥", "您的共享密钥"

# 或者，如果没有提供API密钥和共享密钥，FlickRaw将尝试从环境变量中读取：
# ENV['FLICKRAW_API_KEY']
# ENV['FLICKRAW_SHARED_SECRET']

flickr = FlickRaw::Flickr.new

简单使用

list = flickr.photos.getRecent

id = list[0].id
secret = list[0].secret
info = flickr.photos.getInfo photo_id: id, secret: secret

puts info.title           # => "PICT986"
puts info.dates.taken     # => "2006-07-06 15:16:18"

认证

token = flickr.get_request_token
auth_url = flickr.get_authorize_url token['oauth_token'], perms: 'delete'

puts "在浏览器中打开此URL完成认证过程：#{auth_url}"
puts "认证完成后，复制这里给出的数字。"
verify = gets.strip

begin
  flickr.get_access_token token['oauth_token'], token['oauth_token_secret'], verify
  login = flickr.test.login
  puts "您已认证为 #{login.username}，使用令牌 #{flickr.access_token} 和密钥 #{flickr.access_secret}"
rescue FlickRaw::FailedResponse => e
  puts "认证失败：#{e.msg}"
end

上传照片

PHOTO_PATH = '照片.jpg'

# 您需要进行认证，请参考前面的示例。
flickr.upload_photo PHOTO_PATH, title: "标题", description: "这是描述"

代理

require 'flickraw'
FlickRaw.proxy = "http://user:[e-mail]:3129/"

服务器证书验证

服务器证书验证默认为启用状态。如果您不想验证服务器证书：

require 'flickraw'
FlickRaw.check_certificate = false

CA证书文件路径

OpenSSL::X509::DEFAULT_CERT_FILE 用作CA证书文件。如果您想更改路径：

require 'flickraw'
FlickRaw.ca_file = '/path/to/cacert.pem'

3. 项目API使用文档

Flickraw提供了多种方法来访问Flickr API，包括获取照片信息、上传照片、构建Flickr URL等。

获取照片信息

info = flickr.photos.getInfo photo_id: "3839885270", secret: "照片密钥"
puts info.title           # 输出照片标题

构建Flickr URL

info = flickr.photos.getInfo photo_id: "3839885270"
puts FlickRaw.url_b(info) # 输出照片的大尺寸URL

4. 项目安装方式

请参考上述安装指南进行项目安装。

以上就是关于Flickraw库的详细使用和技术文档。希望对您有所帮助！