Обработка ошибок

Ответы на запросы API могут содержать сообщение о той или иной ошибке. В этом разделе вы найдете сведения об ошибках, их коды и основную информацию об их устранении.

Ответы с сообщениями об ошибках

Это стандартный ответ с сообщением об ошибке запроса API:

{
  "error": {
    "message": "Message describing the error", 
    "type": "OAuthException", 
    "code": 190,
    "error_subcode": 460,
    "error_user_title": "A title",
    "error_user_msg": "A message",
    "fbtrace_id": "EJplcsCHuLu"
  }
}

message — описание ошибки в понятной для человека форме.
code — код ошибки. Ниже перечислены распространенные значения и способы устранения ошибок.
error_subcode — дополнительная информация об ошибке. Распространенные значения перечислены ниже.
error_user_msg — сообщение, отображаемое для пользователя. Язык сообщения определяется в соответствии с языком в запросе API.
error_user_title — заголовок диалога (если отображается). Язык сообщения определяется в соответствии с языком в запросе API.
fbtrace_id — внутренний идентификатор поддержки. Если вы отправляете нам сообщение об ошибке, связанной с вызовом Graph API, добавьте в него параметр fbtrace_id. Он поможет нам найти данные журнала для отладки. Однако срок действия этого ID быстро истекает. Чтобы в службе поддержки могли воспроизвести вашу проблему, прикрепите сохраненный сеанс Graph Explorer.

Коды ошибок

Код или тип	Имя	Решение
OAuthException		Отсутствие подкода означает, что срок действия статуса входа или маркера доступа истек либо они отозваны или недействительны. Получите новый маркер доступа. Если подкод указан, ориентируйтесь на него.
102	Сеанс API	Отсутствие подкода означает, что срок действия статуса входа или маркера доступа истек либо они отозваны или недействительны. Получите новый маркер доступа. Если подкод указан, ориентируйтесь на него.
1	Неизвестный API	Возможно, это временная ошибка из-за отключения. Подождите немного и повторите операцию. Если это происходит снова, убедитесь, что вы запрашиваете существующий API.
2	Служба API	Временная ошибка из-за отключения. Подождите немного и повторите операцию.
3	Метод API	Проблема с возможностями или разрешениями. Убедитесь, что у вашего приложения есть необходимые возможности и разрешения для этого вызова.
4	Слишком много вызовов API	Временная ошибка из-за регулирования. Подождите немного и повторите попытку или проверьте количество своих запросов API.
17	Слишком много вызовов пользователей API	Временная ошибка из-за регулирования. Подождите немного и повторите попытку или проверьте количество своих запросов API.
10	Разрешение на доступ к API отменено	Разрешение не предоставлено или отозвано. См. раздел обработка отсутствующих разрешений.
190	Истек срок действия маркера доступа	Получите новый маркер доступа.
200–299	Разрешение API (в зависимости от разрешения значений может быть несколько)	Разрешение не предоставлено или отозвано. См. раздел обработка отсутствующих разрешений.
341	Достигнут предел для приложения	Временная ошибка из-за отключения или регулирования. Подождите немного и повторите попытку или проверьте количество своих запросов API.
368	Временно заблокировано из-за нарушений политики	Подождите немного и повторите операцию.
506	Дублирование публикации	Дублированные публикации нельзя публиковать последовательно. Измените контент публикации и повторите попытку.
1609005	Ошибка публикации ссылки	При попытке скрапинга данных по указанной ссылке возникла проблема. Проверьте URL и повторите попытку.

Дополнительные коды ошибок аутентификации

Код	Имя	Решение
458	Приложение не установлено	Пользователь не вошел в ваше приложение. Повторно авторизуйте пользователя.
459	Пользователь проверяется	Чтобы решить проблему, пользователь должен войти на сайт https://www.facebook.com или https://m.facebook.com.
460	Изменен пароль	Если на устройствах с iOS 6 и более поздних версий используется процесс входа на Facebook, интегрированный с ОС, направьте пользователя на страницу настроек Facebook в ОС на его устройстве, чтобы он обновил пароль. В противном случае пользователю потребуется вновь войти в приложение.
463	Истек срок действия	Состояние входа или маркер доступа отозваны, у них истек срок действия или они стали недействительными по другой причине. См. раздел Обработка маркеров доступа с истекшим сроком действия.
464	Неподтвержденный пользователь	Чтобы решить проблему, пользователь должен войти на сайт https://www.facebook.com или https://m.facebook.com.
467	Недействительный маркер доступа	Маркер доступа отозван, у него истек срок действия или он стал недействительным по другой причине. См. раздел Обработка маркеров доступа с истекшим сроком действия.
492	Недействительный сеанс	У пользователя, связанного с маркером доступа к Странице, нет соответствующей роли на Странице.

Коды ошибок, связанные с ограничением числа обращений

Дополнительные сведения о кодах ошибок, связанных с ограничением числа обращений, см. в руководстве по ограничению числа обращений API Graph.