사용자 정의 자격 증명 유형을 사용하는 방법
웹 서비스 데이터 작업 통합을 추가할 때 자격 증명 유형을 선택할 수 있습니다. 기본 인증, 사용자 정의 또는 사용자 정의(OAuth). 자세한 내용은 데이터 작업 통합 추가 그리고 자격 증명 유형.
이 문서에서는 사용자 정의 자격 증명 유형을 사용하는 방법에 대해 설명합니다.
- 통합을 추가할 때 사용자 정의 자격 증명을 구성합니다.
사용 중인 API의 필드 이름과 해당 필드 이름의 값을 추가하십시오.
- 생성하는 모든 사용자 지정 작업의 요청에서 자격 증명의 필드 이름을 사용합니다.
다음 예는 날씨 가져오기라는 사용자 지정 작업에 대한 요청입니다. 신임장 다른 Velocity 매크로와 함께 사용할 수 있는 정적 키워드입니다. API_키 자격 증명 구성에 추가한 필드 이름입니다. 자세한 내용은 데이터 작업을 위한 속도 매크로.
통합은 필드 이름의 값을 수정하지만 실제 값은 웹 서비스에 나타납니다. 예를 들어 API_키 가 12345이면 작업이 실행될 때 웹 서비스에 표시되는 requestUrlTemplate은 "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=12345"입니다. 자세한 내용은 사용자 지정 작업 만들기, 사용자 지정 작업에 구성 추가, 그리고 구성 요청.
주의: 내에서 입력 또는 출력 변수를 사용하지 않도록 하십시오. 요청 템플릿, 성공템플릿, 또는 요청 URL 템플릿. 특수 문자로 변수를 적절히 이스케이프하지 않으면 데이터 작업이 실행되지 않습니다.- 사용하다 esc.json문자열 JSON 본문 내에서 문자열을 이스케이프합니다.
자세한 내용은 의 esc.jsonString 섹션을 참조하십시오. 데이터 작업을 위한 속도 매크로.
- 사용하다 esc.url() 또는 urlTool.OptionalQueryParam() 경로 또는 쿼리 매개변수를 적절히 이스케이프하려면 요청 URL 템플릿 또는 요청 템플릿 사용하는 경우 x-www.form-urlencoded 가치.
자세한 내용은 문자열 이스케이프 라이브러리 섹션을 참조하십시오. 데이터 작업을 위한 속도 매크로.
이스케이프는 JSON 컨텍스트에 따라 다르므로 다음 예제에서는 의도적으로 이스케이프를 표시하지 않습니다.
{ "requestUrlTemplate": "https://api.openweathermap.org/data/2.5/weather?q=London&APPID=${credentials.API_Key}", "requestType": "GET", "headers": {}, "requestTemplate": "${input.rawRequest}" }
참고: 사용자 지정 작업을 테스트할 때 통합은 모든 권한 부여 정보를 수정합니다. 자세한 내용은 사용자 지정 작업 테스트. - 사용하다 esc.json문자열 JSON 본문 내에서 문자열을 이스케이프합니다.
통합에 대한 자세한 내용은 다음을 참조하십시오. 웹 서비스 데이터 작업 통합 정보.