서버 할당
경고: Clanforge용 API 기술 자료입니다. Multiplay Hosting을 사용 중이라면, Multiplay Hosting API 기술 자료를 참고하십시오.
하나 이상의 할당에 대한 세부 정보를 반환합니다.
요청된 할당 상태를 모니터링하기 위해 매치메이커가 이 엔드포인트를 폴링해야 합니다. 한 번에 최대 100개의 할당을 배치로 폴링하는 것이 좋습니다.
https://api.multiplay.co.uk/cfp/v1/server/allocations메서드 | 콘텐츠 유형 |
| GET | application/x-www-form-urlencoded |
요청 파라미터
| 변수 | 설명 | 선택 사항 |
| fleetid | <fleetid> 파라미터는 할당이 속한 플릿의 ID를 받습니다. | 아니요 |
| uuid | <uuid> 파라미터는 서로 다른 할당 UUID를 사용하여 두 번 이상 제공할 수 있습니다. 응답 본문에는 지정된 할당에 대한 정보가 포함됩니다.지정된 UUID는 모두 동일한 플릿에 속해야 합니다. | 아니요 |
응답 필드
| 필드 | 유형 | 설명 | 선택 사항 |
|---|---|---|---|
| profileid | 정수 | 이 서버가 사용하는 프로필의 ID | 아니요 |
| uuid | 문자열 | 할당 ID | 아니요 |
| regions | 문자열 | 이 게임 서버가 속한 영역의 ID | 아니요 |
| created | 문자열 | 할당이 생성된 시간 | 아니요 |
| requested | 문자열 | 할당이 요청된 시간 | 아니요 |
| fulfilled* | 문자열 | 할당이 이행된 시간 | 아니요 |
| ready* | 문자열 | 할당이 플레이어를 받을 수 있는 상태로 표시된 시간 | 예 |
| serverid* | 정수 | 이 할당의 서버 ID | 아니요 |
| fleetid | 문자열 | 이 서버가 속한 플릿의 ID | 아니요 |
| regionid* | 문자열 | 이 서버가 속한 영역의 ID | 아니요 |
| machineid* | 정수 | 이 서버가 있는 머신의 ID | 아니요 |
| ip* | 문자열 | 이 게임 서버의 IP(v4) 주소 | 아니요 |
| ipv6* | 문자열 | 이 게임 서버의 IP(v6) 주소(플릿에서 지원하는 경우) | 예 |
| game_port* | 정수 | 이 게임 서버의 네트워크 포트 | 아니요 |
| error | 문자열 | 할당 중에 발생한 모든 오류의 세부 정보 | 예 |
별표(*)로 표시된 필드는 할당 프로세스가 완료될 때까지 빈 문자열로 반환될 수 있습니다.
요청 예시
curl --location --request GET 'https://api.multiplay.co.uk/cfp/v1/server/allocations?fleetid=<fleetid>&uuid=<uuid>&uuid=<uuid>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'응답 예시
{
"success": true,
"messages": [],
"allocations": [
{
"profileid": <profileid>,
"uuid": <uuid>,
"regions": <regions>,
"created": <created>,
"requested": <requested>,
"fulfilled": <fufilled>,
"serverid": <serverid>,
"fleetid": <fleetid>,
"regionid": <regionid>,
"machineid": <machineid>,
"ip": <ip>,
"ipv6": <ipv6>,
"game_port": <port>,
"error": <error>,
"ready": <status>
}
]
}