APP定位
? 圖片壁紙 采用Splash網(wǎng)站，提供的后臺(tái)支持墨状，開發(fā)的第三方圖片壁紙客戶端杯瞻。
API 說(shuō)明
-
地址
網(wǎng)站的baseUrl: https://api.unsplash.com/, 響應(yīng)的數(shù)據(jù)均以Json的數(shù)據(jù)格式返回扭吁。
-
版本
網(wǎng)站的版本均為v1 , 建議在http協(xié)議的請(qǐng)求報(bào)文中指定 Accept-Version 屬性：
Accept-Version: v1
-
HTTP 請(qǐng)求動(dòng)作
- GET 獲取資源
- POST 創(chuàng)建資源
- PUT 更新資源
- DELETE 刪除資源
-
錯(cuò)誤信息
如果發(fā)生錯(cuò)誤球碉，服務(wù)器和客戶端都會(huì)收到錯(cuò)誤信息蜓斧，錯(cuò)誤信息以 errors 數(shù)組 組成。例如
404 未找到網(wǎng)頁(yè)
{ "errors": ["Username is missing", "Password cannot be blank"] } -
認(rèn)證
//TODO
-
分頁(yè)
返回多頁(yè)的數(shù)據(jù)的時(shí)候汁尺，默認(rèn)使用 page 表示頁(yè)數(shù)法精，使用 per_page 表示每頁(yè)返回的數(shù)據(jù) 默認(rèn)每頁(yè)數(shù)據(jù)返回10條，每頁(yè)最多可返回30條數(shù)據(jù)痴突。
如果不支持分頁(yè)搂蜓，默認(rèn)返回第一頁(yè)數(shù)據(jù)。
-
請(qǐng)求限制
當(dāng) 程序處于開發(fā)者模式辽装，UnSplash的API 請(qǐng)求次數(shù)限定為每小時(shí) 50次帮碰，當(dāng)程序通過(guò)審核 請(qǐng)求的次數(shù)可以提高到每小時(shí)500次，每一次請(qǐng)求后拾积，在相應(yīng)頭里面都會(huì)返回當(dāng)前的剩余的請(qǐng)求次數(shù)
X-Ratelimit-Limit: 1000 X-Ratelimit-Remaining: 999目前只有Json的請(qǐng)求數(shù)據(jù)會(huì)被計(jì)算其中（eg , api.unsplash.com）殉挽，圖片文件請(qǐng)求（images.unsplash.com）不會(huì)被計(jì)算到請(qǐng)求限制中。如果需要更高的請(qǐng)求 請(qǐng)聯(lián)系我們拓巧。
-
用戶
//TODO
-
照片
- 獲取 一頁(yè)照片
請(qǐng)求方式
GET /photos
參數(shù)：
參數(shù) 描述 page 請(qǐng)求的頁(yè)數(shù)（默認(rèn) 1） per_page 每頁(yè)返回的數(shù)據(jù)個(gè)數(shù)（默認(rèn) 10） order_by 可選項(xiàng) 數(shù)據(jù)如果排序（有效值 ：latest ,oldest,popular） 響應(yīng)格式：
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
參數(shù)
參數(shù) 描述 id 必選項(xiàng)： 照片的I w 照片的寬度 單位為像素 h 照片的高度 單位為像素 rect 四個(gè)逗號(hào)分隔的整數(shù) 分別代表裁剪矩形的 x, y, width, height。 響應(yīng)
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 :當(dāng)使用請(qǐng)求參數(shù) w h 會(huì)導(dǎo)致裁剪的照片 返回的數(shù)據(jù)會(huì)新增urls對(duì)象:
```
{
// ...
"urls": {
"raw": "...",
"full": "...",
"regular": "...",
"small": "...",
"thumb": "...",
"custom": "https://images.unsplash.com/your-custom-image.jpg"
}
}
```
搜索
?
收藏列表
API狀態(tài)
//TODO
