APP定位
? 圖片壁紙 采用Splash網站，提供的后臺支持，開發的第三方圖片壁紙客戶端。
API 說明
-
地址
網站的baseUrl: https://api.unsplash.com/, 響應的數據均以Json的數據格式返回。
-
版本
網站的版本均為v1 , 建議在http協議的請求報文中指定 Accept-Version 屬性：
Accept-Version: v1
-
HTTP 請求動作
- GET 獲取資源
- POST 創建資源
- PUT 更新資源
- DELETE 刪除資源
-
錯誤信息
如果發生錯誤，服務器和客戶端都會收到錯誤信息，錯誤信息以 errors 數組 組成。例如
404 未找到網頁
{ "errors": ["Username is missing", "Password cannot be blank"] } -
認證
//TODO
-
分頁
返回多頁的數據的時候，默認使用 page 表示頁數，使用 per_page 表示每頁返回的數據 默認每頁數據返回10條，每頁最多可返回30條數據。
如果不支持分頁，默認返回第一頁數據。
-
請求限制
當 程序處于開發者模式，UnSplash的API 請求次數限定為每小時 50次，當程序通過審核 請求的次數可以提高到每小時500次，每一次請求后，在相應頭里面都會返回當前的剩余的請求次數
X-Ratelimit-Limit: 1000 X-Ratelimit-Remaining: 999目前只有Json的請求數據會被計算其中（eg , api.unsplash.com），圖片文件請求（images.unsplash.com）不會被計算到請求限制中。如果需要更高的請求 請聯系我們。
-
用戶
//TODO
-
照片
- 獲取 一頁照片
請求方式
GET /photos
參數：
參數 描述 page 請求的頁數（默認 1） per_page 每頁返回的數據個數（默認 10） order_by 可選項 數據如果排序（有效值 ：latest ,oldest,popular） 響應格式：
200 OK Link: <https://api.unsplash.com/photos?page=1>; rel="first", <https://api.unsplash.com/photos?page=1>; rel="prev", <https://api.unsplash.com/photos?page=346>; rel="last", <https://api.unsplash.com/photos?page=3>; rel="next" X-Ratelimit-Limit: 1000 X-Ratelimit-Remaining: 999
[ { "id": "LBI7cgq3pbM", "created_at": "2016-05-03T11:00:28-04:00", "width": 5245, "height": 3497, "color": "#60544D", "likes": 12, "liked_by_user": false, "user": { "id": "pXhwzz1JtQU", "username": "poorkane", "name": "Gilbert Kane", "portfolio_url": "https://theylooklikeeggsorsomething.com/", "bio": "XO", "location": "Way out there", "total_likes": 5, "total_photos": 74, "total_collections": 52, "profile_image": { "small": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/face-springmorning.jpg?q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128" }, "links": { "self": "https://api.unsplash.com/users/poorkane", "html": "https://unsplash.com/poorkane", "photos": "https://api.unsplash.com/users/poorkane/photos", "likes": "https://api.unsplash.com/users/poorkane/likes", "portfolio": "https://api.unsplash.com/users/poorkane/portfolio" } }, "current_user_collections": [ // The *current user's* collections that this photo belongs to. { "id": 206, "title": "Makers: Cat and Ben", "published_at": "2016-01-12T18:16:09-05:00", "curated": false, "cover_photo": { "id": "xCmvrpzctaQ", "width": 7360, "height": 4912, "color": "#040C14", "likes": 12, "liked_by_user": false, "user": { "id": "eUO1o53muso", "username": "crew", "name": "Crew", "portfolio_url": "https://crew.co/", "bio": "Work with the best designers and developers without breaking the bank. Creators of Unsplash.", "location": "Montreal", "total_likes": 0, "total_photos": 74, "total_collections": 52, "profile_image": { "small": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128" }, "links": { "self": "https://api.unsplash.com/users/crew", "html": "http://unsplash.com/crew", "photos": "https://api.unsplash.com/users/crew/photos", "likes": "https://api.unsplash.com/users/crew/likes", "portfolio": "https://api.unsplash.com/users/crew/portfolio" } }, "urls": { "raw": "https://images.unsplash.com/photo-1452457807411-4979b707c5be", "full": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy", "regular": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=1080&fit=max", "small": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=400&fit=max", "thumb": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=200&fit=max" }, "categories": [ { "id": 6, "title": "People", "photo_count": 9844, "links": { "self": "https://api.unsplash.com/categories/6", "photos": "https://api.unsplash.com/categories/6/photos" } } ], "links": { "self": "https://api.unsplash.com/photos/xCmvrpzctaQ", "html": "https://unsplash.com/photos/xCmvrpzctaQ", "download": "https://unsplash.com/photos/xCmvrpzctaQ/download", "download_location": "https://api.unsplash.com/photos/xCmvrpzctaQ/download" } }, "user": { "id": "eUO1o53muso", "username": "crew", "name": "Crew", "bio": "Work with the best designers and developers without breaking the bank. Creators of Unsplash.", "portfolio_url": "https://crew.co/", "bio": "Work with the best designers and developers without breaking the bank. Creators of Unsplash.", "location": "Montreal", "total_likes": 0, "total_photos": 74, "total_collections": 52, "profile_image": { "small": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128" }, "links": { "self": "https://api.unsplash.com/users/crew", "html": "https://unsplash.com/crew", "photos": "https://api.unsplash.com/users/crew/photos", "likes": "https://api.unsplash.com/users/crew/likes", "portfolio": "https://api.unsplash.com/users/crew/portfolio" } }, "links": { "self": "https://api.unsplash.com/collections/206", "html": "https://unsplash.com/collections/206", "photos": "https://api.unsplash.com/collections/206/photos" } }, // ... more collections ], "urls": { "raw": "https://images.unsplash.com/face-springmorning.jpg", "full": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg", "regular": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=1080&fit=max", "small": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=400&fit=max", "thumb": "https://images.unsplash.com/face-springmorning.jpg?q=75&fm=jpg&w=200&fit=max" }, "links": { "self": "https://api.unsplash.com/photos/LBI7cgq3pbM", "html": "https://unsplash.com/photos/LBI7cgq3pbM", "download": "https://unsplash.com/photos/LBI7cgq3pbM/download", "download_location": "https://api.unsplash.com/photos/LBI7cgq3pbM/download" } }, // ... more photos ]
-
獲取策劃的照片
GET /photos/curated
其他格式同上。
-
獲取特定Id的照片
GET /photos/:id
參數
參數 描述 id 必選項： 照片的I w 照片的寬度 單位為像素 h 照片的高度 單位為像素 rect 四個逗號分隔的整數 分別代表裁剪矩形的 x, y, width, height。 響應
200 OK X-Ratelimit-Limit: 1000 X-Ratelimit-Remaining: 999 { "id": "Dwu85P9SOIk", "created_at": "2016-05-03T11:00:28-04:00", "width": 2448, "height": 3264, "color": "#6E633A", "downloads": 1345, "likes": 24, "liked_by_user": false, "exif": { "make": "Canon", "model": "Canon EOS 40D", "exposure_time": "0.011111111111111112", "aperture": "4.970854", "focal_length": "37", "iso": 100 }, "location": { "city": "Montreal", "country": "Canada", "position": { "latitude": 45.4732984, "longitude": -73.6384879 } }, "current_user_collections": [ // The *current user's* collections that this photo belongs to. { "id": 206, "title": "Makers: Cat and Ben", "published_at": "2016-01-12T18:16:09-05:00", "curated": false, "cover_photo": { "id": "xCmvrpzctaQ", "width": 7360, "height": 4912, "color": "#040C14", "likes": 12, "liked_by_user": false, "user": { "id": "eUO1o53muso", "username": "crew", "name": "Crew", "portfolio_url": "https://crew.co/", "bio": "Work with the best designers and developers without breaking the bank.", "location": "Montreal", "total_likes": 0, "total_photos": 74, "total_collections": 52, "profile_image": { "small": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128" }, "links": { "self": "https://api.unsplash.com/users/crew", "html": "http://unsplash.com/crew", "photos": "https://api.unsplash.com/users/crew/photos", "likes": "https://api.unsplash.com/users/crew/likes", "portfolio": "https://api.unsplash.com/users/crew/portfolio" } }, "urls": { "raw": "https://images.unsplash.com/photo-1452457807411-4979b707c5be", "full": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy", "regular": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=1080&fit=max", "small": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=400&fit=max", "thumb": "https://images.unsplash.com/photo-1452457807411-4979b707c5be?ixlib=rb-0.3.5&q=80&fm=jpg&crop=entropy&w=200&fit=max" }, "categories": [ { "id": 6, "title": "People", "photo_count": 9844, "links": { "self": "https://api.unsplash.com/categories/6", "photos": "https://api.unsplash.com/categories/6/photos" } } ], "links": { "self": "https://api.unsplash.com/photos/xCmvrpzctaQ", "html": "https://unsplash.com/photos/xCmvrpzctaQ", "download": "https://unsplash.com/photos/xCmvrpzctaQ/download", "download_location": "https://api.unsplash.com/photos/xCmvrpzctaQ/download" } }, "user": { "id": "eUO1o53muso", "username": "crew", "name": "Crew", "portfolio_url": "https://crew.co/", "bio": "Work with the best designers and developers without breaking the bank.", "location": "Montreal", "total_likes": 0, "total_photos": 74, "total_collections": 52, "profile_image": { "small": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=32&w=32", "medium": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=64&w=64", "large": "https://images.unsplash.com/profile-1441298102341-b7ba36fdc35c?ixlib=rb-0.3.5&q=80&fm=jpg&crop=faces&fit=crop&h=128&w=128" }, "links": { "self": "https://api.unsplash.com/users/crew", "html": "https://unsplash.com/crew", "photos": "https://api.unsplash.com/users/crew/photos", "likes": "https://api.unsplash.com/users/crew/likes", "portfolio": "https://api.unsplash.com/users/crew/portfolio" } }, "links": { "self": "https://api.unsplash.com/collections/206", "html": "https://unsplash.com/collections/206", "photos": "https://api.unsplash.com/collections/206/photos" } }, // ... more collections ], "urls": { "raw": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d", "full": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg", "regular": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=1080&fit=max", "small": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=400&fit=max", "thumb": "https://images.unsplash.com/photo-1417325384643-aac51acc9e5d?q=75&fm=jpg&w=200&fit=max" }, "categories": [ { "id": 4, "title": "Nature", "photo_count": 24783, "links": { "self": "https://api.unsplash.com/categories/4", "photos": "https://api.unsplash.com/categories/4/photos" } } ], "links": { "self": "https://api.unsplash.com/photos/Dwu85P9SOIk", "html": "https://unsplash.com/photos/Dwu85P9SOIk", "download": "https://unsplash.com/photos/Dwu85P9SOIk/download" "download_location": "https://api.unsplash.com/photos/Dwu85P9SOIk/download" }, "user": { "id": "QPxL2MGqfrw", "username": "exampleuser", "name": "Joe Example", "portfolio_url": "https://example.com/", "bio": "Just an everyday Joe", "location": "Montreal", "total_likes": 5, "total_photos": 10, "total_collections": 13, "links": { "self": "https://api.unsplash.com/users/exampleuser", "html": "https://unsplash.com/exampleuser", "photos": "https://api.unsplash.com/users/exampleuser/photos", "likes": "https://api.unsplash.com/users/exampleuser/likes", "portfolio": "https://api.unsplash.com/users/exampleuser/portfolio" } } }
? Note :當使用請求參數 w h 會導致裁剪的照片 返回的數據會新增urls對象:
```
{
// ...
"urls": {
"raw": "...",
"full": "...",
"regular": "...",
"small": "...",
"thumb": "...",
"custom": "https://images.unsplash.com/your-custom-image.jpg"
}
}
```
搜索
?
收藏列表
API狀態
//TODO
