플릿 할당
경고: Clanforge용 API 기술 자료입니다. Multiplay Hosting을 사용 중이라면, Multiplay Hosting API 기술 자료를 참고하십시오.
플릿 할당은 더 이상 할당 UUID를 보유하고 있지 않지만 아직 시간 초과되지 않은 할당을 찾는 데 유용한 유틸리티 엔드포인트입니다.
이 엔드포인트를 할당을 모니터링하는 매치메이커 플로의 일부로 사용해선 안 됩니다. 대신 서버 할당을 사용하십시오.
https://api.multiplay.co.uk/cfp/v2/fleet/<fleetid>/allocations메서드 |
| GET |
요청 파라미터
| 변수 | 설명 | 선택 사항 |
| fleetid | <fleetid> 파라미터는 할당이 속한 플릿의 ID를 받습니다. | 아니요 |
| age | <age> 파라미터는 응답의 각 할당이 활성 상태로 지속된 최소 시간을 나타내는 Golang time.Duration 유형 값을 받습니다. 예를 들어, 24h를 값으로 제공하면 24시간 이상 활성 상태로 유지된 모든 할당이 반환됩니다. | 아니요 |
| limit | <limit> 파라미터는 응답에 포함될 할당의 최대 수를 나타내는 정수를 받습니다. <limit>의 값은 10에서 50 사이여야 합니다. 기본값은 10입니다. | 예 |
| empty | <empty> 파라미터는 부울 값을 받습니다.
false로 설정되거나 이 변수가 제외된 경우, 응답에 빈 할당과 비어 있지 않은 할당이 포함됩니다. | 예 |
응답 필드
| 필드 | 유형 | 설명 | 선택 사항 |
|---|---|---|---|
| profileid | 정수 | 이 서버가 사용하는 프로필의 ID | 아니요 |
| uuid | 문자열 | 할당 ID | 아니요 |
| regions | 문자열 | 이 게임 서버가 속한 영역의 ID | 아니요 |
| created | 문자열 | 할당이 생성된 시간 | 아니요 |
| requested | 문자열 | 할당이 요청된 시간 | 아니요 |
| eta | 문자열 | 할당이 이행될 것으로 예상되는 시간 | 아니요 |
| fulfilled | 문자열 | 할당이 이행된 시간 | 아니요 |
| ready | 문자열 | 할당이 플레이어를 받을 수 있는 상태로 표시된 시간 | 예 |
| serverid | 정수 | 이 할당의 서버 ID | 아니요 |
| fleetid | 문자열 | 이 서버가 속한 플릿의 ID | 아니요 |
| regionid | 문자열 | 이 서버가 속한 영역의 ID | 아니요 |
| machineid | 정수 | 이 서버가 있는 머신의 ID | 아니요 |
| ip | 문자열 | 이 게임 서버의 IP(v4) 주소 | 아니요 |
| ipv6 | 문자열 | 이 게임 서버의 IP(v6) 주소(플릿에서 지원하는 경우) | 예 |
| game_port | 정수 | 이 게임 서버의 네트워크 포트 | 아니요 |
요청 예시
curl --location --request GET 'https://api.multiplay.co.uk/cfp/v2/fleet/<fleetid>/allocations?age=<age>&limit=<limit>&empty=<empty>' \
--header 'Authorization: Basic YOUR_AUTH_CREDENTIALS'응답 예시
[
{
"profileid": <profileid>,
"uuid": <uuid>,
"requestid": <requestid>,
"regions": <regions>,
"requested": <requested>,
"created": <created>,
"fulfilled": <fulfilled>,
"eta": <eta>,
"serverid": <serverid>,
"fleetid": <fleetid>,
"regionid": <regionid>,
"machineid": <machineid>,
"ip": <ip>,
"ipv6": <ipv6>,
"game_port": <port>,
"ready": <status>
},
...
]