HttpRequest

HttpRequest 함수는 지정된 URL로 HTTP 요청을 보내고 응답을 반환한다.

주의) 상대 서버 응답 지연으로, 감시프로그램이 최대 30초간 대기상태로 유지될 수 있다.

이를 방지하려면, 감시 실행 중 계속 스크립트의 "스레드 사용" 기능을 이용하여 요청 플래그(flag)가 ON 될 때 HttpRequest 함수가 실행되도록 스크립트를 작성하도록 한다.

string @HttpRequest(string method, string url, string data, string headerId);

함수인자

string method : HTTP 메서드 (GET, POST, PUT, PATCH, DELETE)

string url : 요청 URL

string data : 요청 본문 데이터 (GET, DELETE는 무시됨)

string headerId : 사용할 헤더 컬렉션의 식별자

반환 값

성공 시 응답 본문

실패 시 빈 문자열

예제 1)

// GET 요청 예제

string method = "GET";

string url = "https://api.example.com/data";

string data = ""; // GET에서는 무시됨

string headerId = "myHeader";

string response = @HttpRequest(method, url, data, headerId);

예제 2)

// POST 요청 예제

method = "POST";

url = "https://api.example.com/users";

data = @JsonToString(buf);      // buf 예제 값 : "{\"name\":\"홍길동\",\"email\":\"hong@example.com\"}";

response = @HttpRequest(method, url, data, headerId);

예제 3)

// PUT 요청 예제

method = "PUT";

url = "https://api.example.com/users/123";

data = @JsonToString(buf);      // buf 예제 값 : "{\"name\":\"김철수\"}";

response = @HttpRequest(method, url, data, headerId);

예제 4 (통합 사용 예제)

// 헤더 생성

string headerId = "apiHeader";

@HttpCreateHeader(headerId);

// 헤더 추가

@HttpAddHeader(headerId, "Content-Type", "application/json");

@HttpAddHeader(headerId, "Accept", "application/json");

@HttpAddHeader(headerId, "User-Agent", "AutoBase/1.0");

// 또는 헤더 파일에서 구성 로드

@HttpLoadHeaderConfig(headerId, "common_api");

// API 요청 수행

string data = @JsonToString(buf);      // buf 예제 값 : "{\"query\":\"사용자 데이터\"}"

string response = @HttpRequest("POST", "https://api.example.com/data", data, headerId);

if( response != "") @Message("성공적으로 데이터를 받았습니다.");

else @Message("요청에 실패했습니다.");

// 사용 후 헤더 제거

@HttpRemoveHeader(headerId);

예제 5)

@HttpCreateHeader("header1");

@HttpLoadHeaderConfig("header1","api1");

data = @JsonTemplateLoad("test");

url = "http://192.168.1.2:5000/obj";

buf = @HttpRequest("POST",url, data, "header1");

@ObjectSetText("Text1", buf);

예제 6 (네이버 API 쇼핑 검색)

@HttpCreateHeader("header1");
@HttpAddHeader("header1","X-Naver-Client-Id","TestClientId12345");     //네이버 API ID 입력
@HttpAddHeader("header1","X-Naver-Client-Secret","TestClientSecret");  //네이버 API 비밀번호 입력

url = "https://openapi.naver.com/v1/search/shop.json?query=Autobase&display=1&start=1&sort=sim";  //Autobase 검색
responseString = @HttpRequest("GET", url, "", "header1");    //httpMethod, url, data, header 순
@ObjectSetText("Text1", responseString);   //전체 응답

buf1 = @StringJson(responseString, "$.items[0].link"); //첫번째 제품 링크만 추출.
@ObjectSetText("Text2", buf1);

버전정보

최초지원: 10.3.6.25

관련 항목)

HttpCreateHeader

HttpAddHeader

HttpRemoveHeader

HttpLoadHeaderConfig

HttpRequest