Использование токена

Токен нужно передавать серверу в тех случаях, когда для выполнения действия необходима авторизация.

Токен указывается в HTTP-заголовке Authorization:

• В случае OAuth-авторизации:

  Authorization: OAuth e78cf1a0ebbb19...

• При FimpToken-авторизации:

  Authorization: FimpToken realm="fotki.yandex.ru", token="e78cf1a0ebbb19..."

При OAuth-авторизации токен также можно передавать в качестве query-параметра:

http://api-fotki.yandex.ru/api/me/?oauth_token=e78cf1a0ebbb19...

Возможные ошибки

• 400 Bad Request

  Сообщение не соответствует формату (заголовок Authorization содержит ошибки).

• 401 Unauthorized
  • Анонимный пользователь попытался выполнить запрос, требующий авторизации:

    401 Unauthorized
    WWW-Authenticate: FimpToken realm="fotki.yandex.ru" 
    
    Authorization required

  • Неизвестная схема аутентификации или недопустимый токен (при использовании FimpToken-авторизации):

    401 Unauthorized
    WWW-Authenticate: FimpToken realm="fotki.yandex.ru" 
    
    Invalid token
    FimpToken realm="fotki.yandex.ru", token="e78cf1a0ebbb..."

  • Недопустимый токен (при использовании OAuth-авторизации):

    401 Unauthorized
    WWW-Authenticate: OAuth realm="fotki.yandex.ru", error="expired_token"

  • В заголовке отсутствует параметр token (при использовании FimpToken-авторизации):

    401 Unauthorized
    WWW-Authenticate: FimpToken realm="fotki.yandex.ru" 
    
    No token
    FimpToken realm="fotki.yandex.ru"

  • В заголовке отсутствует параметр realm (при использовании FimpToken-авторизации):

    401 Unauthorized
    WWW-Authenticate: FimpToken realm="fotki.yandex.ru" 
    
    No realm
    FimpToken token="e78cf1a0ebbb..."

  • Параметр realm не равен "fotki.yandex.ru" (при использовании FimpToken-авторизации):

    401 Unauthorized
    WWW-Authenticate: FimpToken realm="fotki.yandex.ru" 
    
    Invalid realm
    FimpToken realm="example.com", token="e78cf1a0ebbb..."

• 403 Forbidden

  Авторизованный пользователь попытался изменить чужие данные:

  403 Forbidden 
  You are not authorized to perform this operation