HTTP 요청 함수 설명 및 활용 예제
이 문서에서는 HTTP 요청을 생성하고 전송하는 함수에 대해 설명합니다. HTTP 요청은 RESTful API를 사용할 때 HTTP 헤더를 통한 인증 등 다양한 용도로 사용될 수 있습니다.
함수 설명
함수: http_request
이 함수는 일반적인 HTTP 요청을 생성하고 전송합니다. 다음과 같은 매개변수가 필요합니다:
- URL: 요청할 웹 주소입니다.
- 요청 방법:
"GET","HEAD","POST","PUT","DELETE","TRACE","OPTIONS"또는"CONNECT"중 하나입니다. - 헤더 맵: HTTP 헤더를 포함하는 키/값 쌍의 DS 맵입니다. 헤더 필드와 필요한 데이터는 문자열 형식으로 제공되며, 콜론(
:)은 포함되지 않아야 합니다. - 선택적 요청 본문: 데이터 문자열(빈 문자열
""도 가능) 또는 이진 데이터용 버퍼입니다.
이 함수는 비동기 요청 ID를 반환하며, 이 ID는 콜백을 식별하는 데 사용됩니다.
비동기 콜백
이 함수는 비동기 HTTP 이벤트에 의해 수신되는 "콜백"을 생성합니다. 이 경우, 요청 함수와 관련된 DS 맵이 생성되어 특별한 변수 async_load에 저장됩니다. 이 DS 맵에는 다음과 같은 두 개의 키가 포함됩니다:
- "id": 함수에서 반환된 ID입니다. 여러 개의 HTTP 요청을 보낼 경우, 어떤 요청에 대한 응답인지 확인하기 위해 이 값을 사용합니다.
- "response_headers": 값이 0 이상인 경우, HTTP 요청에 대한 응답으로 반환된 HTTP 헤더를 포함하는 DS 맵을 보유합니다.
함수 구문
http_request(url, method, header_map, body);
매개변수 설명
| 매개변수 | 타입 | 설명 |
|---|---|---|
| url | String | 정보를 얻고자 하는 서버의 웹 주소입니다. |
| method | String | 요청 방법 (일반적으로 "GET" 또는 "POST", 모든 방법 지원) |
| header_map | DS Map | 필수 헤더 필드가 포함된 DS 맵 |
| body | String 또는 Buffer | 헤더 다음에 전송될 데이터 (이진 버퍼 핸들 가능) |
반환값
- 비동기 요청 ID (문제가 발생하면 -1)
활용 예제
아래는 HTTP 요청을 생성하고 전송하는 예제 코드입니다.
var _headers = ds_map_create();
ds_map_add(_headers, "Authorization", "Basic eW95b19hZG1pbjpjNG5lZmllbGQ=");
ds_map_add(_headers, "Content-Type", "application/x-www-form-urlencoded");
ds_map_add(_headers, "Cookie", "request_method=GET; _InAppPurchases_session=69bb6ef6eec2b");
var _data = "utf8=%E2%9C%93&authenticity_token=kPmS14DcYcuKgMFZUsN3XFfj3mhs%3D&product%5Bname%5D=CatchTheHaggis&product%5Bproduct_id%5D=http_test&commit=Create+Product";
request_id = http_request("http://225.0.0.97:3000/products", "POST", _headers, _data);
ds_map_destroy(_headers);
위 코드는 요청에 필요한 HTTP 헤더를 포함하는 DS 맵을 생성하고, POST 요청에 사용할 데이터 문자열을 생성합니다. 마지막으로, 함수를 호출하고 그 ID 값을 request_id 변수에 저장하여 HTTP 비동기 이벤트에서 확인할 수 있도록 합니다.
추가적인 활용 예제는 다음과 같습니다:
// GET 요청 예제
var _get_headers = ds_map_create();
ds_map_add(_get_headers, "Accept", "application/json");
var get_request_id = http_request("http://example.com/api/data", "GET", _get_headers, "");
ds_map_destroy(_get_headers);
// PUT 요청 예제
var _put_headers = ds_map_create();
ds_map_add(_put_headers, "Authorization", "Bearer your_token_here");
ds_map_add(_put_headers, "Content-Type", "application/json");
var put_data = "{\"name\":\"New Item\",\"price\":100}";
var put_request_id = http_request("http://example.com/api/items/1", "PUT", _put_headers, put_data);
ds_map_destroy(_put_headers);
이 예제들은 GET 및 PUT 요청을 수행하는 방법을 보여줍니다. 각 요청에 대해 필요한 헤더를 설정하고, 요청 본문을 정의한 후, http_request 함수를 호출합니다.