플렉스튜디오 API 연동 테스트 기능으로 오류 해결하기

API를 사용하다 보면 의도치 않게 오류가 발생하는 경우가 있어요. 이번 글에서는 플렉스튜디오의 API 연동 테스트 기능을 활용해 문제를 빠르게 찾아내고 해결하는 방법을 소개할게요.

예시로 OpenAI API를 통해 사용자의 요리실력을 고려해 레시피를 추천해 주는 앱을 사용하겠습니다. 예시 앱에 대한 더 자세한 과정이 궁금하다면 ‘플렉스튜디오 데이터 연동 : OpenAI API 연동’강의를 참고해 주세요!

플렉스튜디오 유튜브에서 영상 강의 확인하기 ▼

1. 디버거 오류가 생겨요! : 서비스 오류

① 테스트 기능 사용해서 원인 분석

• 디버거에서 보내는 데이터 복사
  
  
  
  
• 워크스페이스 - 좌측 데이터 메뉴 - API 연동 버튼 - 테스트 탭 클릭
  
  
  
  
• Test Param Blocks에 데이터 붙여넣기

• TEST CALL 실행
  
  
  
  
  • 예시 앱의 오류 메시지 내용 : 401 코드 오류 발생
    
    
    
    
  • API 응답 코드는 코드 값마다 의미가 다름 (401 Unauthorized – 인증 정보가 유효하지 않습니다.)

② 해결 방법

• Header의 인증값과 Advanced Key Setting의 Key를 비교하여 수정

• 수정 후 다시 테스트하여 정상적으로 호출되는지 확인

• 정상 동작이 확인되면 우측 하단의 배포 버튼 클릭

• 디버거에서도 동일하게 동작하는지 재확인
  • 디버거 사용하는 방법 : 시나리오 우측 상단의 화살표( ▶ ) 클릭

2. 함께 알아두면 좋은 정보 : API 테스트 중 코드 번호가 없는 오류가 생겨요!

① 원인

• Script 문법 오류일 가능성 높음

② 해결 방법

• 테스트 기능을 활용하여 오류 메시지를 확인하고 API 호출 단계별 검토
  • 예시 앱에서 발생한 오류 : item is not defined

• item 변수가 포함된 Script 확인

• 수정 후 다시 테스트하여 정상적으로 호출되는지 확인

시나리오에서 API 연동 기능을 사용하기 전에 미리 테스트를 진행하면 실제 응답 구조와 인증 방식을 미리 확인할 수 있고 개발 과정에서 생기는 오류와 혼란을 줄일 수 있어요. 추가로 궁금한 점이 있다면 [플렉스튜디오 가이드]나 [커뮤니티]를 참고해 주세요!