연동 빌더를 사용할 때 API 요청 본문에서 문자열, 숫자, 부울 및 배열과 같은 유형의 요청 매개변수를 전달할 수 있습니다. 이 기능은 API 연동의 유연성을 높이고 더 광범위한 사용 사례를 지원합니다. 이 문서에서는 이러한 매개변수를 구성하는 프로세스를 안내해 드립니다.
이 문서에서는 다음과 같은 주제를 다룹니다.
관련 문서:
요청 매개변수에서 매개변수 유형 설정하기
요청 매개변수에서 매개변수 유형을 설정하려면 다음과 같이 하세요.
- 연동 빌더에서 요청 매개변수 섹션으로 이동합니다.
- 매개변수를 정의하고 유형을 다음 중 하나로 설정합니다.
- 문자열 : 따옴표로 묶인 텍스트 데이터의 경우(예: "example text")
- 번호: 숫자 값의 경우(예: 123).
- 부울 : true/false 값의 경우.
-
배열 : 값 모음의 경우(예: ["item1", "item2"])
배열 매개변수에 대한 서식 다시 지정 추가
배열 유형의 매개변수가 있는 연동 서비스 빌더에서 테스트 목적으로 데이터 유형이 올바르게 처리되도록 다시 서식 지정 함수를 추가해야 합니다. 이렇게 하려면 다음 함수를 사용하세요.
$eval($)
이 함수는 문자열 값을 배열 개체로 구문 분석합니다.
매개변수가 이미 배열 개체인 경우에는 함수가 동작을 변경하지 않습니다.
자세한 내용은 AI 상담사의 요청 매개변수에서 값 다시 서식 지정하기를 참조하세요.
API 호출 요청 본문에서 매개변수 사용하기
API 호출 요청 본문에서 이러한 매개변수는 {{< REQUEST_PARAMETER> }}
아래 스크린샷에서 볼 수 있듯이 매개변수가 본문에 시각적으로 문자열로 나타날 수 있지만 실행 중에는 요청 매개변수 섹션에 지정된 해당 데이터 유형으로 변환됩니다.
구성 테스트하기
연동 서비스 빌더에서 테스트 프로덕션 버튼을 사용하여 API 호출을 실행합니다.
요청에서 올바른 유형(문자열, 숫자, 부울, 배열)으로 매개변수가 전달되고 있는지 확인합니다.
응답을 검토하여 API가 제대로 처리하는지 확인하세요.
번역 고지 사항: 본 문서는 콘텐츠에 대한 기본적인 이해를 제공하기 위해 자동 번역 소프트웨어를 사용하여 번역되었습니다. 정확한 번역을 제공하고자 합당한 노력을 기울였으나 Zendesk는 번역의 정확성을 보장하지 않습니다.
번역된 문서에 포함된 정보의 정확성과 관련하여 질문이 있으시면 문서의 공식 버전인 영문 버전을 참조하시기 바랍니다.