API OAuth 인증 오류 문제 해결

Last updated: October 9, 2026

Edvisor API의 500 내부 서버 오류 및 인증 문제에 대한 안내입니다.

1. API 엔드포인트 확인

현재 엔드포인트만 사용하세요: https://api-v2.edvisor.io/graphql.

이전 엔드포인트 https://api.edvisor.io/graphql는 더 이상 사용되지 않습니다. 이전 엔드포인트 요청은 실패하거나 차단될 수 있습니다.

2. Authorization 헤더 확인

다음 형식과 정확히 일치해야 합니다: Authorization: Bearer <your_edvisor_api_key>.

일반적인 오류:

  • 헤더 이름의 오타.

  • Bearer 접두사 누락.

  • 불필요한 공백.

3. API 키 확인

  • 키가 제공받은 키와 일치하는지 확인하세요.

  • 붙여넣는 과정에서 실수로 변경되지 않았는지 확인하세요.

  • 확실하지 않은 경우 지원팀에 새 키 생성을 요청하세요.

4. 올바른 Content-Type 설정

다음 값이어야 합니다: application/json.

Edvisor API가 페이로드를 해석하려면 필요합니다.

5. 삭제된 사용자 확인

API 키는 사용자에게 연결되어 있습니다. 사용자가 삭제되면 해당 API 키가 작동하지 않습니다. 지원팀에 문의하여 새 API 키를 생성하세요.

6. 오타 확인

모든 헤더와 구성 필드를 철저히 확인하세요. 작은 오타로도 인증이 차단됩니다.

7. 지원팀에 문의

모든 단계를 수행해도 문제가 해결되지 않는 경우:

오류 응답 또는 로그를 첨부하세요. 변경한 내용과 받은 오류 코드를 기록하면 양 팀이 더 빠르게 해결하는 데 도움이 됩니다.

대상별 해결을 위해 관련 제품 또는 엔드포인트(Edvisor 지불, 보험 등)를 명시하세요.