REST API 튜토리얼
Access Cloud Save data from any development environment with the REST API.
읽는 시간 1분최근 업데이트: 7달 전
REST API를 사용하여 Cloud Save의 데이터에 액세스할 수 있습니다.
REST API를 사용하면 유연성이 향상되며 원하는 언어와 게임 개발 엔진 또는 게임 서버를 사용해 워크플로를 자동화할 수 있습니다.
Cloud Save 서비스에서 제공되는 REST API는 다음과 같습니다.
- 플레이어 작업용 Cloud Save 플레이어 API(예: 데이터 저장/로딩)
- 관리자 작업용 Cloud Save 관리자 API(예: 쿼리/인덱스 구성)
참고
Cloud Save 서비스에서는 플레이어별로 분당 600개의 요청 비율 제한을 적용합니다.
Authentication
Multiplay Hosting 토큰이나 상태 비보존 토큰을 사용하여 Cloud Save REST API에 대한 요청을 인증할 수 있습니다. 받은 토큰을 요청 헤더에서 HTTP 인증을 위한 bearer 토큰으로 사용합니다.
참고
게임 서버에서 Multiplay 토큰으로 인증하는 것이 좋습니다. 상태 비보존 토큰으로 인증하려면 서비스 계정을 생성하고 비공개 키를 안전하게 보관해야 하지만, Multiplay 토큰을 사용하면 그럴 필요가 없으며 관리가 덜 복잡합니다.
Multiplay Hosting 토큰으로 인증
게임 서버에서 다음 요청을 실행하여 Multiplay Hosting 토큰을 검색할 수 있습니다.
curl -X GET http://localhost:8086/v4/token
이 요청은 다음과 같은 포맷의 응답을 반환합니다.
{"token":"<BEARER_TOKEN>", "error":""}
상태 비보존 토큰을 사용한 인증
상태 비보존 토큰을 사용하려면 서비스 계정을 생성하고 토큰 교환 API를 호출하여 제한된 수명의 상태 비보존 토큰을 발급받아야 합니다.
REST API 호출
코드베이스에 기본으로 제공되는 HTTP 라이브러리를 사용하여 모듈 엔드포인트를 호출할 수 있습니다. 검색된 인증 토큰을 요청 헤더에서 HTTP 인증을 위한 bearer 토큰으로 사용합니다.
플레이어의 데이터를 저장하기 위한 CURL 요청 예제는 다음과 같습니다.
curl -X POST -H 'Authorization: Bearer <BEARER_TOKEN>' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{"key":"someKey","value":"someValue"}' \ 'https://cloud-save.services.api.unity.com/v1/data/projects/<PROJECT_ID>/players/<PLAYER_ID>/items'