menu
Is this helpful?

# 오픈 API

이 문서에 기록된 내용은 TE의 고급 사용 기능에 속하며, 더 기술적인 세부 정보가 포함되어 있으며, 관련 경험이 있는 개발자가 참조하기에 적합합니다. 문서 내용에 대해 질문이 있는 경우, 저희 매니저에게 문의해주세요.

TE는 분석 Web 뿐만 아니라, 풍부한 API도 제공하고 있습니다.

# 호출 방법

# 쿼리 키 생성

Open API를 사용하기 전에 프로젝트 키를 먼저 생성해야 합니다. 프로젝트 키에는 두 가지 유형이 있습니다. 프로젝트 키를 생성하는 명령은 ta-tool에서 실행해야 합니다.

TA 서버에 로그인하여 "su - ta" 명령을 실행하여 ta 사용자로 전환한 다음 ta-tool을 실행합니다.

루트 키 생성

ta-tool generate_root_secret
  • 이 키는 모든 프로젝트에 적용됩니다.

단일 프로젝트용 키 생성

ta-tool generate_api_secret -appid TEST-APPID
  • 전달된 인자는 해당 프로젝트의 APPID입니다. 생성된 키는 해당 프로젝트에만 사용될 수 있습니다.

참고: 같은 프로젝트나 루트 키가 반복 실행될 경우, 새 키가 생성되며 이전 키는 무효화됩니다.

# API 호출 규칙

API는 HTTP GET 또는 POST 방식을 사용하여 호출 요청을 제출하며, 호출 URL은 다음과 같습니다:

http://$HOST:8992/$API_PATH?token=$API_SECRET

$HOST는 서버 주소를 의미하며, 보통 ta2입니다. $API_PATH는 특정 API 경로를 의미하며, 예를 들어 open/event-analyze입니다. $API_SECRET는 키입니다.

API는 HTTP GET 또는 POST 방식을 사용하여 호출 요청을 제출합니다. POST 요청 메시지 본문은 JSON 형식입니다. 자세한 매개변수 구성은 관련 문서를 확인해주세요.

응답 메시지 본문은 JSON 형식이며, 기본 구조는 다음과 같습니다.

{
"return_code": 0,
"return_message": "성공",
"data": {...},
"stackMessage": "",
"showStackMessage": false
}

필드

설명

return_code 반환 코드 0은 성공을 의미하며, 그 외는 실패를 나타냅니다(자세한 지침은 다음 표에 나와 있습니다)
return_message 반환 메시지
data 호출 결과 데이터
stackMessage 실패 시 비정상 스택
showStackMessage TE 제품의 프론트 엔드에서 사용됩니다(OpenAPI 호출 시 이 필드를 무시할 수 있음); 비정상 스택의 복사 버튼을 표시할지 여부를 나타냅니다

return_code 반환 코드 세부 사항

Return code

반환 코드 지침

0

성공적으로 실행됨

-1

실행에 실패함

-1001

로그인하지 않음

-10012

로그인 실패

-10013

로그아웃 실패

-1002

계정이 잠겼습니다. 관리자에게 문의하여 문제를 해결하세요

-1003

사용자 이름 또는 비밀번호 오류. 확인 후 다시 로그인하세요

-1004

문제가 발생했습니다. 나중에 다시 시도하거나 저희에게 문의하세요

-1005

요청이 너무 빈번합니다. 나중에 다시 시도하세요

-1006

운영 권한이 없습니다

-1007

SSO 로그인 실패

-1008

매개변수 오류

-1009

사용자 이름이 존재하지 않음

-1010

불법적인 운영

-1011

데이터 준비되지 않음

-1012

현재 데이터 없음

-1013

데이터 준비 중

-1014

잘못된 접근

-1015

이미 존재함

-1020

전화번호가 잘못됨

-1021

이 프로젝트의 멤버 이미 존재함

-1022

요청 취소됨

-1023

대상 객체가 존재하지 않음

-1099

커스텀 이벤트 표현이 불완전하거나 불법적임

-1100

생성 가능한 객체의 수를 초과함

-1999

유효하지 않은 사용자

-2000

등록되지 않은 사용자, 등록 및 활성화 후 유효해짐

-2001

등록된 사용자, 활성화 후 다음 로그인 때 유효해짐

-2002

사용자가 프로젝트에 있음

-2003

운영자의 권한은 운영 대상보다 낮을 수 없음

-2004

매개변수가 누락됨, 관리자에게 문의하세요

-2005

운영 권한이 없음

-2006

데이터가 업데이트됨

-3000

라이센스 인증 실패

-3001

라이센스 인증 실패. TE 고객 서비스에 문의하여 문제를 해결하세요

-3004

프로젝트가 유효하지 않음

-3005

MFA 검증 실패, 잘못되거나 만료된 MFA 검증 코드

-3006

현재 기업은 MFA 가상 장치에 대한 강제 로그인 검증을 활성화했습니다. 장치를 바인딩하세요

-3007

현재 사용자가 MFA 가상 장치를 바인딩했습니다. 바인딩 과정을 반복할 수 없습니다

-3008

현재 유저는 가상MFA 장치에 로그인 인증을 유효하게 설정했으나, MFA 인증 코드가 부족합니다.

-3009

운영자는 지원되지 않습니다