오류 처리

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: 내부 지원 식별자입니다. 그래프 API 호출과 관련된 버그를 보고할 때 fbtrace_id를 포함하면 디버그를 위한 로그 데이터를 찾는 데 도움이 됩니다. 그러나 이 ID는 잠시 후면 만료됩니다. 지원팀이 문제를 재현하는 데 도움을 줄 수 있도록 저장된 그래프 탐색기 세션을 첨부해 주세요.

오류 코드

코드 또는 유형	이름	취해야 할 조치
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 이상 버전에서 사용자가 OS 통합 플로를 사용하여 로그인한 경우 비밀번호를 업데이트하려면 기기의 Facebook OS 설정으로 이동해야 합니다. 그렇지 않으면 앱에 다시 로그인해야 합니다.
463	만료됨	로그인 상태 또는 액세스 토큰이 만료되었거나 취소되었거나 잘못되었습니다. 만료된 액세스 토큰을 처리합니다.
464	확인되지 않은 사용자	문제를 수정하려면 사용자가 https://www.facebook.com 또는 https://m.facebook.com에서 로그인해야 합니다.
467	잘못된 액세스 토큰	액세스 토큰이 만료되었거나 취소되었거나 잘못되었습니다. 만료된 액세스 토큰을 처리합니다.
492	잘못된 세션	페이지 액세스 토큰과 연결된 사용자가 페이지에서 적절한 역할이 없습니다.

사용 제한 오류 코드

사용 제한 오류 코드에 대한 자세한 내용은 그래프 API 사용 제한 가이드를 참조하세요.