REST API 튜토리얼#

REST API를 사용하여 Cloud Save의 데이터에 액세스할 수 있습니다.

REST API를 사용하면 유연성이 향상되며 원하는 언어와 게임 개발 엔진 또는 게임 서버를 사용해 워크플로를 자동화할 수 있습니다.

Cloud Save 서비스에서 제공되는 REST API는 다음과 같습니다.

• 플레이어 작업용 Cloud Save 플레이어 API(예: 데이터 저장/로딩)
• 관리자 작업용 Cloud Save 관리자 API(예: 쿼리/인덱스 구성)

Authentication#

Multiplay Hosting 토큰이나 상태 비보존 토큰을 사용하여 Cloud Save REST API에 대한 요청을 인증할 수 있습니다. 받은 토큰을 요청 헤더에서 HTTP 인증을 위한 bearer 토큰으로 사용합니다.

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'