연결 메서드 오류 처리
연결 → error 확인 → 터미널 id 보관. MT5 연결 결과를 차례로 확인합니다.
단계별 설명
- 0:00
연결 메서드 오류 처리
이 튜토리얼은 MT5 연결 메서드의 오류 처리 방법을 설명합니다. HTTP 상태 코드와 API 오류를 확인하고, 어떤 응답이 연결 성공을 의미하는지 살펴봅니다.
- 0:17
메서드별 결과 가이드 열기
엠티 파이브 점 엠알피씨 점 프로를 여세요. 왼쪽에서 메서드를 선택하고 코드 예제 아래의 요청 성공 여부 확인 가이드를 펼칩니다. 선택한 메서드에 따라 설명이 달라집니다.
- 0:36
1. HTTP 상태 코드 확인
먼저 HTTP 상태 코드를 확인하세요. HTTP 상태 코드 이백은 API가 요청을 받고 응답을 반환했다는 뜻입니다. 이어서 JSON 본문을 읽습니다. 다른 상태 코드라면 HTTP 오류와 응답 본문부터 확인하세요.
- 0:59
2. 계속하기 전에 error 확인
error가 null이 아니면 data를 사용하기 전에 errorCode와 errorMessage를 읽으세요. 가이드에서 해당 코드의 설명과 조치 방법을 찾습니다. HTTP 상태 코드 이백만으로 연결 성공을 판단할 수는 없습니다.
- 1:19
3. 연결된 터미널 확인
Connect Ex가 성공하면 data의 terminalInstanceGuid를 반환합니다. 이후 요청에 사용할 터미널 식별자를 보관하세요. API 키는 접근 권한을, 터미널 식별자는 이 연결을 나타냅니다. 다른 연결 메서드는 각자의 응답 필드를 확인하세요.
- 1:44
로그인 거부: 인증 정보 확인
로그인이 거부되면 계좌 번호와 거래 비밀번호, 정확한 서버 이름을 확인하세요. 비밀번호가 맞아도 다른 서버에 접속하면 실패합니다. Connect에서는 호스트와 포트를, Connect Proxy에서는 프록시 정보도 확인합니다.
- 2:04
서버에 접근할 수 없는 경우
서버를 찾을 수 없다면 정확한 이름을 사용하거나 Get Broker Servers By Broker Name으로 조회하세요. 서버에 접근할 수 없다면 호스트, 포트, 네트워크 연결을 확인합니다. 보고된 원인을 수정한 뒤 재시도하세요.
- 2:26
시간 초과: 연결 상태부터 확인
연결 시간이 초과되면 결과가 아직 확정되지 않은 상태입니다. 새로운 연결을 만들기 전에 Connect State를 읽으세요. 연결 중이라면 기다리고, 실패했다면 원인을 수정한 뒤 다시 연결합니다.
- 2:46
완전한 터미널 id 사용
이 화면은 잘못된 터미널 식별자를 사용한 실제 Account Summary 요청입니다. HTTP 상태 코드 이백과 함께 API 오류가 반환되었습니다. Connect Ex가 반환한 완전한 id로 수정한 뒤 조회 요청을 다시 실행하세요.
- 3:08
연결 확인의 세 단계
연결 메서드는 세 단계로 확인합니다. HTTP 상태 코드, 오류 코드와 메시지, 연결 결과와 터미널 식별자 순서입니다. 메서드별 설명을 따르고, 애플리케이션 작업이 끝나면 터미널 연결을 종료하세요.