기타 메서드의 결과와 오류
계좌, 시장, 기록, 계산, 스트림 메서드. 빈 목록, 0, false도 유효한 결과일 수 있습니다.
단계별 설명
- 0:00
기타 메서드의 결과와 오류
이 영상은 계좌 데이터, 시장 정보, 기록, 계산, WebSocket 스트림 등 기타 MT5 메서드의 결과와 오류 처리를 설명합니다.
- 0:14
선택한 메서드의 가이드 열기
엠티 파이브 점 엠알피씨 점 프로를 여세요. Account Summary나 Opened Orders 등 필요한 메서드를 선택하고 코드 예제 아래의 가이드를 펼칩니다. 해당 메서드에 맞는 설명을 읽으세요.
- 0:34
1. HTTP 상태 코드 확인
먼저 HTTP 상태 코드를 확인하세요. HTTP 상태 코드 이백은 API가 요청을 받고 응답을 반환했다는 뜻입니다. 이어서 JSON 본문을 읽습니다. 다른 상태 코드라면 HTTP 오류와 응답 본문부터 확인하세요.
- 0:57
2. error 확인
두 번째로 error를 확인합니다. null이 아니라면 errorCode와 errorMessage를 읽으세요. 여기서는 실제 Account Summary 요청이 HTTP 상태 코드 이백을 반환했지만, 터미널 식별자가 잘못되었습니다. 빨간 결과에 수정 방법이 표시됩니다.
- 1:22
잘못되거나 없는 세션 수정
잘못된 식별자는 Connect Ex가 반환한 완전한 id로 수정합니다. 터미널이 없다면 식별자와 플랫폼을 확인한 뒤 터미널 상태를 확인하세요. 세션이 종료되었다면 유효한 연결을 만든 후 계좌 요청을 계속해야 합니다.
- 1:44
각 메서드의 data 해석
계좌, 시장, 기록, 계산 메서드는 error 확인 후 각 메서드의 data를 읽습니다. 빈 목록은 일치하는 항목이 없다는 뜻이고, 영은 포지션이 없다는 뜻일 수 있습니다. false는 정상적인 부정 응답일 수 있으므로 자동으로 API 실패로 판단하지 마세요.
- 2:07
정확한 결과 필드 읽기
Account Summary는 계좌 정보를, Positions Total은 포지션 수를 반환합니다. 계산 메서드는 예상 증거금이나 수익을 반환할 뿐 거래를 실행하지 않습니다. 기록 목록이 비어 있다면 필터와 기간을 확인하세요.
- 2:28
터미널이 바쁘면 기다린 뒤 재시도
Busy나 Rate Limit Exceeded가 반환되면 error의 properties에서 RetryAfterSeconds를 확인하세요. 지정된 시간만큼 기다리고 동시 요청을 줄입니다. 조회 시간 초과라면 터미널 상태를 확인한 뒤 준비되었을 때 다시 시도하세요.
- 2:51
스트림은 메시지마다 확인
WebSocket은 들어오는 메시지마다 error를 확인한 후 data를 처리하세요. 소켓이 열려 있어도 모든 작업이 성공한 것은 아닙니다. 데이터가 잠시 없거나 빈 하트비트가 와도 실패는 아닙니다. 연결이 끊기면 필요에 따라 재연결하고 현재 계좌 상태를 다시 읽으세요.
- 3:16
기타 메서드 확인의 세 단계
일반 메서드는 HTTP 상태 코드, error, 메서드 고유의 data 순서로 확인합니다. 스트림은 모든 수신 메시지를 확인하세요. 진단 정보는 보관하되, 응답을 공유하기 전에는 인증 정보와 계좌 정보를 제거하세요.