환경
Ruby는 개발 및 통합 테스트를 위한 테스트 환경과 라이브 트래픽을 위한 프로덕션 환경, 두 가지 별도의 환경을 제공합니다.
기본 URL
| 환경 | 기본 URL |
|---|---|
| 테스트 | https://api-test.ruby-gaming.com |
| 프로덕션 | https://api.ruby-gaming.com |
모든 API 경로는 두 환경에서 동일합니다. 예:
테스트: https://api-test.ruby-gaming.com/api/brand/create
프로덕션: https://api.ruby-gaming.com/api/brand/create
team_api_key와 team_api_secret은 환경별로 발급됩니다. 테스트 자격 증명은 프로덕션에서 사용할 수 없으며, 그 반대도 마찬가지입니다. 통합 테스트가 완료되면 Ruby 담당 매니저에게 연락하여 프로덕션 자격 증명을 받으십시오.
HTTPS / TLS
모든 API 호출에 HTTPS가 필수입니다. 일반 HTTP 연결은 허용되지 않습니다. Ruby는 모든 엔드포인트에 TLS를 적용합니다.
HTTP 클라이언트가 다음을 충족하는지 확인하십시오:
- 서버의 TLS 인증서를 검증합니다 (인증서 검증을 비활성화하지 마십시오)
- TLS 1.2 이상을 지원합니다
포트
API는 리버스 프록시 뒤에서 제공됩니다. URL에 포트 번호를 지정할 필요가 없습니다 — 위의 기본 URL을 통해 표준 HTTPS 포트(443)를 암시적으로 사용합니다.
권장 클라이언트 타임아웃
모든 API 요청에 대해 30초 타임아웃으로 HTTP 클라이언트를 구성하십시오. 대부분의 요청은 이 시간 내에 충분히 완료됩니다. 타임아웃은 엣지 케이스에서의 연결 중단을 방지합니다.
속도 제한
속도 제한 정책은 추후 공지될 예정입니다.
연동 시 높은 요청량이 필요한 경우, 서비스 오픈 전에 Ruby 담당 매니저에게 연락하여 용량 계획을 논의하십시오.
헬스 체크
API 접근 가능 여부를 확인할 수 있는 공개 헬스 엔드포인트가 제공됩니다:
GET /health
이 엔드포인트는 인증이 필요 없으며, 서비스가 정상 작동 중일 때 HTTP 200을 반환합니다. API 할당량을 소비하지 않고 환경에서의 연결을 확인하는 데 사용할 수 있습니다.
설정 확인
테스트 자격 증명을 받고 HTTPS 연결을 확인한 후, 다음 요청에 서명하여 전송하는 빠른 검증을 수행하십시오:
BASE_URL="https://api-test.ruby-gaming.com"
TIMESTAMP=$(date +%s)
SIGNATURE=$(echo -n "${TIMESTAMP}GET/api/brand/list" \
| openssl dgst -sha256 -hmac "${TEAM_API_SECRET}" -hex | awk '{print $2}')
curl -s "${BASE_URL}/api/brand/list" \
-H "X-Team-Key: ${TEAM_API_KEY}" \
-H "X-Team-Timestamp: ${TIMESTAMP}" \
-H "X-Team-Signature: ${SIGNATURE}"
페이지네이션된 브랜드 목록과 함께 200 응답을 받으면 자격 증명, 서명 로직 및 네트워크 연결이 모두 올바르게 작동하는 것입니다.