Таблица содержит список ресурсов, их адресов и методов для обращения к ним, а также формат обмена данных, указываемый в заголовке Content-Type.
В таблице:
- login - логин пользователя;
- phodo_id - идентификатор фотографии (численный номер);
- album_id - идентификатор альбома (численный номер);
- tag_id - идентификатор альбома (название).
Не рекомендуется использовать указанные ниже адреса программно, так как они со временем могут измениться (за исключением адреса сервисного документа). Клиентское приложение должно всегда начинать работу с API Фоток с получения
сервисного документа (см.
Получение сервисного документа).
| Тип ресурса |
URL |
Методы |
Content-Type |
|
Сервисный документ
|
/api/users/{login}/
|
GET |
application/atomsvc+xml application/json
|
|
Фотография
|
/api/users/{login}/photo/{photo_id}
|
GET PUT DELETE |
application/atom+xml; type=entry application/json; type=entry
|
|
Альбом
|
/api/users/{login}/album/{album_id}/
|
GET PUT DELETE |
application/atom+xml; type=entry application/json; type=entry
|
|
Тег
|
/api/users/{login}/tag/{tag_id}/* |
GET PUT DELETE |
application/atom+xml; type=entry application/json; type=entry
|
|
Коллекция альбомов
|
/api/users/{login}/albums/
|
GET POST |
application/atom+xml; type=feed application/json; type=feed
|
|
Коллекция фотографий альбома
|
/api/users/{login}/album/{album_id}/photos/
|
GET POST
|
application/atom+xml; type=feed application/json; type=feed
|
|
Общая коллекция фотографий
|
/api/users/{login}/photos/
|
GET POST
|
application/atom+xml; type=feed application/json; type=feed
|
|
Коллекция тегов
|
/api/users/{login}/tags/
|
GET |
application/atom+xml; type=feed application/json; type=feed
|
|
Коллекция фотографий тега
|
/api/users/{login}/tag/{тег}/photos/
|
GET |
application/atom+xml; type=feed application/json; type=feed
|
*Идентификатором тега является его имя. Тег не имеет идентификационного номера.
В таблице URL ресурсов приведены без префиксной части http://api-fotki.yandex.ru/.
