HTTP

HTTP 연동은 Macro Deck에서 웹 요청을 보냅니다. 웹훅을 호출하거나, 웹 API가 있는 네트워크 기기를 제어하거나, 온라인 서비스에서 값을 읽어 버튼에 표시할 때 사용하세요. Macro Deck에 포함되어 있고 처음부터 켜져 있으므로 연결하거나 로그인할 것이 없습니다.

두 가지 액션

HTTP 요청 보내기는 요청 전체를 구성합니다. 메서드를 고르고 URL을 입력한 뒤 쿼리 매개변수와 헤더를 이름과 값 쌍으로 추가합니다. 본문 유형에서는 none, json, form, text, multipart(추가 폼 필드가 있는 파일 업로드) 중에서 고릅니다. 인증에서는 basic(사용자 이름과 비밀번호), bearer(토큰), header(이름을 지정한 헤더에 넣는 토큰, 예: X-Api-Key)를 쓸 수 있습니다. 예상 상태는 어떤 응답을 성공으로 볼지 정하며 기본값은 2xx입니다. 시간 제한을 설정하고, 리디렉션 따라가기를 끄고, **최대 응답 크기(바이트)**를 제한할 수도 있습니다.

캡처는 응답의 일부를 변수에 저장합니다. 각 줄은 변수 이름과 선택자로 이루어집니다. 선택자는 $status, $ok, $duration, $body, $truncated, $headers, $header:<name> 또는 data.items[0].name 같은 JSON 경로입니다. 아직 없는 변수는 새로 만들어집니다.

JSON 값 가져오기는 값 하나를 읽는 간단한 방법입니다. URL, JSON 경로를 입력하고 변수에 저장에서 변수를 고르세요.

활용 예

• HTTP 요청 보내기와 본문 유형 json으로 채팅 웹훅에 {"text": "Stream is live"}를 보내는 버튼.
• 네트워크에 있는 스마트 플러그를 로컬 웹 API로 켜는 버튼.
• JSON 값 가져오기로 공개 API에서 현재 가격을 읽고 라벨에 {{ vars.price }}로 표시하는 버튼.
• 요청을 보내고 $status를 캡처한 뒤, 서버가 200으로 응답하지 않으면 만약 / 아니면으로 버튼을 빨간색으로 바꾸는 흐름.

쿼리 매개변수와 헤더의 값에는 {{ vars.channel }} 같은 변수를 넣을 수 있습니다. 요청은 Macro Deck이 실행 중인 컴퓨터에서 실행되므로 http://192.168.1.20 같은 주소로 그 컴퓨터의 네트워크에 있는 기기에 접근할 수 있습니다. 서버에 연결할 수 없거나, 요청 시간이 초과되거나, TLS 인증서가 거부되거나, 상태가 예상과 다르면 액션이 명확한 메시지와 함께 실패합니다.