Watson 예제와 함께 curl 사용

curl 유틸리티를 사용하면 명령행에서 HTTP 요청을 작성할 수 있습니다. 유틸리티는 GET, POST및 기타 HTTP 메소드를 사용하는 요청을 작성하기 위한 단순 인터페이스를 제공합니다. 요청 헤더, 데이터 및 기타 입력을 전달할 수 있으며 호출이 리턴하는 모든 응답 헤더 및 데이터를 표시할 수 있습니다. curl 는 REST API를 실행하기 위해 코드를 작성할 필요가 없기 때문에 IBM Watson® 문서는 curl 를 사용하여 예제 호출을 보여줍니다.

curl 유틸리티는 기본적으로 Apple ® macOS® 및 Microsoft® Windows®의 최신 버전으로 설치됩니다.

macOS, Windows 또는 Linux®에서 curl 를 설치하거나 새로 고치는 방법에 대한 자세한 정보는 curl 설치를 참조하십시오.
curl 및 기능의 전체 범위 사용에 대한 자세한 정보는 모든 curl을 참조하십시오.

curl 은 (는) 응용프로그램 개발에 권장되지 않습니다.

보안 통신을 위해 curl 사용하기

curl 가 시스템에 설치되었는지 여부를 테스트하려면 터미널 프롬프트에서 다음 명령을 실행하십시오.

curl -V

지원되는 프로토콜과 SSL (Secure Sockets Layer) 또는 TLS (Transport Layer Security) 중에서 https 출력이 표시되면 모두 설정됩니다. 모든 IBM Watson Watson 서비스는 클라이언트와 서버 사이의 보안 연결을 위해 이러한 기능을 사용합니다. 인증, 무결성 및 기밀성을 보장하기 위해 로컬 인증서 저장소에 대해 연결 요청이 확인됩니다.

이러한 프로토콜이 나열되지 않는 경우, 요청에 대해 자체 서명 인증서를 사용할 수 있습니다. 그러나 성공적으로 연결하려면 요청과 함께 --insecure 또는 -k 옵션을 포함하여 SSL 검증을 사용 불가능하게 해야 합니다.

SSL 검증을 사용하는 것이 매우 권장된다. SSL을 사용하지 않으면 연결 및 데이터의 보안이 위태롭게 된다. 필요한 경우에만 SSL을 사용 안함으로 설정하고 기밀이 아닌 데이터만 사용하여 가능한 한 빨리 SSL을 사용 가능하게 하십시오.

예제 curl 요청

다음 예제는 curl사용을 보여줍니다. 요청은 Speech to Text 서비스를 사용하여 오디오를 IBM Cloud® 및 IBM Cloud Pak® for Data와 함께 텍스트로 변환합니다.

IBM Cloud

curl -X POST -u "apikey:{apikey}" \
--header "Content-Type: audio/flac" \
--data-binary ./audio-file.flac \
"{url}/v1/recognize"

IBM Cloud Pak for Data

curl -X POST \
--header "Authorization: Bearer {token}" \
--header "Content-Type: audio/flac" \
--data-binary ./audio-file.flac \
"{url}/v1/recognize"

두 예제 모두에서 {url} 를 서비스 인스턴스의 URL로 바꿉니다. 인증은 IBM Cloud®와 다르며, 여기서 {apikey} 를 서비스 인스턴스의 API키로 바꾸고 IBM Cloud Pak® for Data인스턴스에 대해 생성하는 액세스 토큰으로 대체 {token} 니다. 플랫폼에서 서비스에 대한 인증에 대한 자세한 정보는 Watson 서비스로 인증을 참조하십시오.

문서의 예제를 기반으로 요청을 제출할 때 예제에서 중괄호 ({ }) 를 생략하십시오. 이들은 실제 값으로 바꾸어야 하는 변수 값을 나타냅니다. Windows 사용자는 각 행의 끝에 있는 백슬래시 (\) 를 캐럿 (^) 으로 교체해야 합니다. \ 또는 ^뒤에 후행 공백이 없는지 확인하십시오.