1장. 3scale API Management APIcast API 게이트웨이의 고급 작업 소개
3scale APIcast의 고급 작업을 도입하면 API(애플리케이션 프로그래밍 인터페이스)에 대한 액세스 구성을 조정하는 데 도움이 됩니다.
1.1. 3scale API Management API를 호출할 공용 기본 URL 링크 복사링크가 클립보드에 복사되었습니다!
퍼블릭 기본 URL 은 API 소비자가 3scale과 공개적으로 노출되는 API 제품에 대한 요청을 만드는 데 사용하는 URL입니다. 이는 APIcast 인스턴스의 URL입니다.
자체 관리 배포 옵션 중 하나를 사용하는 경우 관리 중인 도메인 이름에 제공된 각 환경에 대해 자체 공개 기본 URL을 선택할 수 있습니다. 이 URL은 API 백엔드와 달라야 하며 https://api.yourdomain.com:443 와 같은 것일 수 있습니다. 여기서 yourdomain.com 은 사용자가 속한 도메인입니다. Public Base URL을 설정한 후 변경 사항을 저장하고 필요한 경우 스테이징의 변경 사항을 프로덕션으로 승격합니다.
지정하는 Public Base URL은 OpenShift 클러스터에서 사용 가능한 포트를 사용해야 합니다. 기본적으로 OpenShift 라우터는 표준 HTTP 및 HTTPS 포트(80 및 443)에서만 연결을 수신 대기합니다. 사용자가 다른 포트를 통해 API에 연결하려면 OpenShift 관리자와 협력하여 포트를 활성화합니다.
APIcast는 공개 기본 URL에 지정된 호스트 이름에 대한 호출만 허용합니다. 예를 들어 https://echo-api.3scale.net:443 을 공용 기본 URL로 지정하는 경우 올바른 호출은 다음과 같습니다.
curl "https://echo-api.3scale.net:443/hello?user_key=you_user_key"
curl "https://echo-api.3scale.net:443/hello?user_key=you_user_key"
API의 공용 도메인이 없는 경우 요청에 APIcast IP 주소를 사용할 수 있지만 도메인이 실제가 아닌 경우에도 공개 기본 URL 필드에 값을 지정해야 합니다. 이 경우 Host 헤더에 호스트를 제공해야 합니다. 예를 들면 다음과 같습니다.
curl "http://192.0.2.12:80/hello?user_key=your_user_key" -H "Host: echo-api.3scale.net"
curl "http://192.0.2.12:80/hello?user_key=your_user_key" -H "Host: echo-api.3scale.net"
로컬 머신에 배포하는 경우 "localhost"를 도메인으로 지정할 수 있으므로 공용 기본 URL은 http://localhost:80 와 같은 요청을 수행할 수 있습니다.
curl "http://localhost:80/hello?user_key=your_user_key"
curl "http://localhost:80/hello?user_key=your_user_key"
API 제품이 여러 개인 경우 각 제품에 대해 Public Base URL을 적절하게 설정합니다. APIcast는 호스트 이름을 기반으로 요청을 라우팅합니다.