HTTP 요청
이 예제를 제공하기 위해 먼저 HTTP의 모든 기본 사항을 설명합니다. 이는 인터페이스의 작동 방식을 이해하는 데 중요합니다.
기본 사항
다음 점들은 반드시 고려해야 합니다:
- HTTP를 통해 요청할 경우 클라이언트에서 연결이 설정되며 서버가 연결을 종료할 때까지 유지됩니다.
- 요청은 TCP를 통해 포트 80(HTTP 암호화되지 않음)과 포트 443(HTTPS 암호화됨)을 사용하여 수행됩니다.
- http://로 포트 80 또는 https://로 포트 443을 사용할 경우 해당 포트는 숨겨집니다.
- HTTP/1.1부터 연결 계층은 일정 시간 동안 연결을 열어두어 TCP 핸드셰이크를 피할 수 있습니다. 이는 Antcas 모니터에서 볼 수 없습니다. 그러나 타임아웃 후 클라이언트, 즉 Antcas 서버가 연결을 닫습니다. 따라서 타임아웃은 충분히 길게 설정해야 합니다.
- 모든 요청은 완전히 backward compatible합니다. 서버가 HTTP/1.0, HTTP/1.1 또는 HTTP/2를 지원하든 관계없이 상관없습니다.
- 헤더는 대소문자를 구분하지 않습니다. 이는 대문자와 소문자가 중요하지 않음을 의미합니다. 그러나 일부 제조업체는 이를 구현하는 데 주의하지 않을 수 있습니다.
- Antcas Control의 문자 인코딩은 항상 UTF-8입니다. 다른 인코딩이 사용되는 경우 필요에 따라 변환해야 합니다.
- URL 포함 쿼리의 최대 길이는 2,083자입니다.
URL의 구조는 다음과 같습니다:
http://server.tld/getdata?project=you%26i+project&id=25#anker
| 구성 요소 | 의미 |
|---|---|
| http:// | 프로토콜을 정의합니다. Antcas Control은 현재 http와 https를 지원합니다. |
| server.tld | 대상 서버의 도메인(DNS) 또는 IP 주소를 정의합니다. |
| getdata | 서버의 URI입니다. 이는 목적지와 유사하며 경로와 같습니다. |
| ?[...] | ?는 URL을所谓의 GET 요청과 분리하며, 그 뒤에 모든 폼 데이터 또는 쿼리가 따라옵니다. 쿼리는 지원되지 않는 문자를 대체하기 위해 항상 인코딩됩니다. |
| #[...] | # 기호는 페이지의 앵커를 정의합니다. 이를 통해 임의의 위치(스크롤)로 이동할 수 있습니다. 이러한 데이터는 서버에 전송되지 않습니다. 또한 이 영역을 포함하여 #을 쿼리에 복사하면 서버에서 다른 목적지를 호출하므로 안 됩니다. |
대상 서버의 구성은 해당 HTTP 게이트웨이에서 수행됩니다.
요청 구조
요청의 구조는 헤더와 본문으로 구성됩니다. 헤더는 첫 번째 줄에 항상 사용된 메서드, URI 및 프로토콜을 표시합니다.
GET /getdata?project=you%26i+project&id=25 HTTP/1.1
Host: server.tld
그 다음은 서버의 응답입니다. 이는 요청의 상태 코드를 포함합니다. 본문은 헤더 뒤에 빈 줄이 따릅니다.
HTTP/1.1 200 OK
Server: Apache2
Content-Type: text/html
<html>안녕하세요 세계</html>
상태 코드
상태 코드는 그룹으로 분류됩니다. 그룹은 첫 번째 숫자로 정의됩니다. 또한 숫자 뒤에 명확한 텍스트 의미가 따릅니다. 다음은 몇 가지 예입니다:
| 상태 | 설명 |
|---|---|
| 200 OK | 요청이 성공했습니다. |
| 301 Found | 실제 페이지로의 리다이렉트. Antcas Control은 링크를 따라가므로 이 응답은 일반적으로 숨겨집니다. |
| 404 Not Found | 지정된 페이지를 찾을 수 없습니다. |
| 500 Internal Server Error | 서버 오류가 발생했습니다. |
메서드
GET 및 POST 메서드는 가장 자주 사용됩니다.
| 메서드 | 설명 |
|---|---|
| GET | GET 요청은 표준 요청입니다. 이는 콘텐츠를 지원하지 않습니다. |
| POST | POST 요청은 서버에 콘텐츠를 보냅니다. 콘텐츠가 비어 있을 수도 있습니다. 장점은 콘텐츠에 길이 제한이 없음을 의미합니다. GET 요청의 경우 특정 수량의 데이터만 전송할 수 있습니다. |
| PUT | PUT은 인터페이스가 정보를 교환하는 데 사용됩니다. |
| DELETE | PUT과 함께 데이터를 삭제하는 데 사용됩니다. |
| (기타) | 다른 HTTP 메서드도 지원되지만 해당 구성이 필요합니다. |
인증
대부분의 인증은 헤더에서 발생합니다. 그러나 쿼리 또는 콘텐츠에 정의된 요청도 있습니다.
실제 요청 전에 세션을 생성해야 할 수 있습니다. 그런 다음 세션이 헤더 Set-Cookie로 설정됩니다. 이 쿠키는 다시 전달되어야 합니다. 쿠키의 내용은 대소문자를 구분하므로 내용이 정확히 일대일로 전달되어야 합니다. 다음은 간소화된 예입니다:
POST /login HTTP/1.1
Host: server.tld
username=myname&password=1234
서버의 응답:
HTTP/1.1 200 OK
Server: Apache2
Content-Type: text/html
Set-Cookie: SESSION=vmvbquk7dq6dbbcq
이제 쿠키를 다음 요청에서 다시 사용할 수 있습니다:
GET /opendoor HTTP/1.1
Host: server.tld
Cookie: SESSION=vmvbquk7dq6dbbcq
팁
브라우저의 개발자 콘솔에서 네트워크 탭을 통해 요청을 평가하고 테스트할 수 있습니다. 또한 헤더를 복사하거나 확인하는 것이 때로는 유용합니다.
구성
Antcas Control에서는 HTTP 인터페이스가 게이트웨이와 함께 생성됩니다. 게이트웨이는 HTTP 클라이언트로 구성됩니다. 여기에서 대상 주소 및 포트(필수)가 적절하게 입력됩니다. 그런 다음 구조에서 요청을 구성합니다. 이를 위해 통신에서 URL을 변수로 입력합니다.
간단한 요청
간단한 요청을 생성하려면 임의의 데이터 유형을 선택합니다. 이는 선호적으로 문자열(string)입니다. 출구에서 값이 변경되면 이미 요청이 수행됩니다. 그런 다음 값이 직접 쿼리로 사용됩니다.
복잡한 요청
HTTP_REQUEST 함수 블록을 사용하여 더 복잡한 요청을 생성합니다. 이를 위해 통신의 데이터 유형을 raw로 설정해야 합니다. 그런 다음 HTTP_RESPONSE 함수 블록을 사용하여 응답을 평가할 수 있습니다. 요청의 ID를 연결해야 응답이 정확하게 할당되도록 해야 합니다.
예제
이 예제에서는 GET 메서드를 사용하여 서버에 데이터를 보내고 응답을 평가합니다. 전체 URL은 다음과 같습니다:
http://server.tld/getdata?project=you%26i+project&id=25
서버에서 데이터를 가져오거나 보내려면 다음 예제를 사용합니다:
참고: 이 예제는 요청을 트리거하는 방법을 보여주지 않습니다. 이는 SET 입력에 양의 에지를 사용하여 트리거됩니다. 의도하지 않은 요청을 방지하려면 DIS 입력을 TRUE로 설정해야 합니다.
인터페이스의 구성은 다음과 같이 구성됩니다:
