[翻译]Pexels免费图片API文档

原文地址: https://www.pexels.com/zh-tw/api/documentation/

如果贵司想请求我们的API, 你可以从这里获取Key. 我们很期待听到你的创意! 获取更到信息可以在API预览页或继续阅读来了解我们的API 如何工作的以及如何集成它.

指南

无论什么时候, 当你发送一个请求的时候, 请确保在突出的位置显示Pexels的链接. 你可以使用文字链接(例如 "照片由 Pexels提供") 或者一个我们Logo的图片链接(下载我们的Logo 白色版或者黑色版).
如果可能的话, 可以将我们的摄影师名称显示出来 (例如 "照片由John Doe 上传到 Pexels" 链接到Pexels的对应页面).
不要复制Pexels的核心功能.
不要滥用 API. API请求限制是每小时不超过 200 次以及每个月不超过 20,000 次. (超过限制请联系我们)

鉴权

在你收到自己的API key后, 你可以开始使用这个API. 你需要在你每次请求的时候将它加到HTTP请求头Authorization上:

Authorization: YOUR_API_KEY

搜索图片

https://api.pexels.com/v1/search?query=example+query&per_page=15&page=1

参数名	解释
query	获取与query相关的照片. (必须)
per_page	定义当前页结果的个数. (默认: 15, 最多: 80)
page	定义当前页的页码. (默认: 1)

如果请求成功, 响应体会是如下格式的JSON:

{
  page: 1,
  per_page: 15,
  total_results: 236,
  url: "https://www.pexels.com/search/example%20query/",
  next_page: "https://api.pexels.com/v1/search/?page=2&per_page=15&query=example+query"
  photos: [{
    width: 1000,
    height: 1000,
    url: "https://www.pexels.com/photo/12345",
    photographer: "Name",
    src: {
      original: "https://*.jpg",
      large: "https://*.jpg",
      large2x: "https://*.jpg",
      medium: "https://*.jpg",
      small: "https://*.jpg",
      portrait: "https://*.jpg",
      landscape: "https://*.jpg",
      tiny: "https://*.jpg"
    }, (NEXT PHOTOS)]
  }
}

上一页/下一页的属性只会出现在非最后一页/第一页的时候

策展图片

https://api.pexels.com/v1/curated?per_page=15&page=1

我们每个小时会添加至少一个照片到我们的策展列表, 所以你可以得到一组不断更新的照片. 有关请求参数和响应格式可以查看上面的搜索方法.

获取一张照片

https://api.pexels.com/v1/photos/:id</pre>

如果你有一张照片的id, 你可以使用它来获取信息

随机照片

如果你想获取随即照片, 你可以使用"策展照片" 以及设置 per_page 为 1 page 设置为1 到1000 的随机数来获取漂亮的随机照片. 如果你想获取随机的指定主题的照片, 可以使用相同的方法.

搜索视频

https://api.pexels.com/videos/search?query=example+query&per_page=15&page=1

参数名称	解释
query	获取query相关的视频. (必须)
per_page	定义当前页结果的个数. (默认: 15, 最多: 80)
page	定义当前页的页码. (默认: 1)
min_width	返回视频的最小宽度. (默认: "")
max_width	返回视频的最大宽度. (默认: "")
min_duration	返回最小时间秒数的视频的 (默认: "")
max_duration	返回最大时间秒数视频. (optional, default: "")

废弃警告: 视频API在video_pictures中返回一个图片数组.video_pictures 已经被废弃, 将会在后面删除.

受欢迎视频

https://api.pexels.com/videos/popular?per_page=15&page=1

参数名称	解释
query	获取query相关的视频. (必须)
per_page	定义当前页结果的个数. (默认: 15, 最多: 80)
page	定义当前页的页码. (默认: 1)
min_width	返回视频的最小宽度. (默认: "")
max_width	返回视频的最大宽度. (默认: "")
min_duration	返回最小时间秒数的视频的 (默认: "")
max_duration	返回最大时间秒数视频. (optional, default: "")

废弃警告: 视频API在video_pictures中返回一个图片数组.video_pictures 已经被废弃, 将会在后面删除.

获取一个视频

https://api.pexels.com/videos/videos/:id

如果你有视频的id, 你可以获取它的信息.

图片格式化

参数名称	解释
original	图片的原始尺寸.
large	大尺寸, 最大宽度940px 以及高度 650px. 具有原图片的纵横比.
large2x	图片最大宽度 1880px 以及最大高度1300px. 具有原图片的纵横比.
medium	高度为 350px 宽度自适应. 具有原图片的纵横比.
small	高度为 130px 宽度自适应. 具有原图片的纵横比.
portrait	宽度 800px 高度 1200px.
landscape	宽度 1200px 高度 627px.
tiny	宽度 280px 高度 200px.

请求统计

要查看这段时间剩余请求次数, 可以查看HTTP请求头 "X-Ratelimit-Remaining".

尝试请求

curl -H "Authorization: YOUR_API_KEY" "https://api.pexels.com/v1/search?query=people"

非官方的封装

免责申明

我们没有正常运行时间或可用性保证。有些功能在未来可能会改变。

联系我们

有问题请写信 api@pexels.com.