콘텐츠로 이동

RESTAPI

종류: EGTools 전용 함수

REST API를 호출해 응답 텍스트를 반환합니다.

구문

=RESTAPI(주소, [방법], [요청헤더], [요청본문])

인수

인수 필수 설명
주소 필수 API URL(GET 파라미터 포함)
방법 선택 "GET"(기본), "POST", "PUT", "PATCH", "DELETE" 등
요청헤더 선택 헤더 이름/값 2열 범위
요청본문 선택 요청 본문 텍스트

반환

응답 본문을 하나의 텍스트 스칼라로 반환합니다(UTF-8로 해석). 주소가 없거나 비었거나 HTTP 요청이 실패하면 #VALUE!를 반환합니다.

예제

수식 결과 설명
=RESTAPI("https://api.example.com/users","GET") 결과는 서버 응답에 따라 다릅니다

참고

  • WinHTTP를 사용하며 네트워크 연결이 필요합니다. 응답 수신 제한 시간은 30초입니다.
  • HTTP 상태 코드와 무관하게 응답 본문을 그대로 반환합니다.
  • 비매크로·스레드 안전으로 등록되어 병렬 재계산이 가능합니다.
  • 주소·방법·요청본문에 배열을 지정하면 #VALUE!를 반환합니다 — 여러 건은 수식을 행별로 복사해 사용합니다.
  • 지원: Excel 2010+. 모든 Excel 버전에서 RESTAPI 이름 그대로 등록됩니다.