> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Limits on Leaderboards

> Rate limits and per-API request quotas for the PlayFab Leaderboards service, covering caller and target entity throttles across create, read, and update calls.

이 가이드의 목적은 리더보드 서비스에서 리더보드를 만들고, 업데이트하고, 읽을 때 적용되는 제한 사항을 자세히 설명하는 것입니다.

* Caller: 이 유형의 제한은 API 호출자에게 적용됩니다. 호출자는 플레이어 또는 타이틀일 수 있습니다.
* Target: 이 유형의 제한은 API의 대상, 여기서는 엔티티에 적용됩니다.

다음 표는 리더보드 서비스에서 사용할 수 있는 다양한 API에 대한 제한을 설명합니다. 여기에 명시적으로 나열되지 않은 API는 기본 동작이 적용됩니다.

| API                            | 제한                               | Caller         | Target 엔티티                                                             |
| ------------------------------ | -------------------------------- | -------------- | ---------------------------------------------------------------------- |
| Default                        | 120초당 50건의 요청                    | Player         | `title_player_account` , `master_player_account`, `group`, `character` |
| GetLeaderboard                 | 120초당 30건의 요청 / 120초당 1,200건의 요청 | Player / Title | N/A                                                                    |
| GetLeaderboardAroundEntity     | 120초당 30건의 요청                    | Player         | `title_player_account`, `master_player_account` , `group`, `character` |
| GetFriendLeaderboardForEntity  | 120초당 30건의 요청                    | Player         | `title_player_account`, `master_player_account` , `group`, `character` |
| GetLeaderboardDefinition       | 120초당 30건의 요청                    | Title          | N/A                                                                    |
| ListLeaderboardDefinitions     | 120초당 30건의 요청                    | Title          | N/A                                                                    |
| CreateLeaderboardDefinition    | 120초당 30건의 요청                    | Title          | N/A                                                                    |
| UnlinkLeaderboardFromStatistic | 120초당 30건의 요청                    | Title          | N/A                                                                    |
| IncrementLeaderboardVersion    | 2분 이내 30건의 요청                    | Title          | N/A                                                                    |

## 리더보드 이벤트의 제한 사항

* `playfab.leaderboard.entity_rank_on_leaderboard_version_ended`
  * 최대 상위 1000위까지만 반환합니다.
  * 엔티티 유형이 `master_player_account` 또는 `external`인 리더보드에서는 동작하지 않습니다.

## 함께 보기

* [기본 리더보드 만들기](/services/playfab/community/leaderboards/create-basic-leaderboard)
* [리더보드 더 활용하기](/services/playfab/community/leaderboards/doing-more-with-leaderboards)
* [시즌 리더보드](/services/playfab/community/leaderboards/seasonal-leaderboards)
* [할당량](/services/playfab/community/leaderboards/quota-leaderboards)
* [그룹 리더보드](/services/playfab/community/leaderboards/group-leaderboards)
* [수동 계층](/services/playfab/community/leaderboards/manual-tiers)
* [통계로 플레이어 순위 매기기](/services/playfab/community/leaderboards/leaderboards-linked-to-stats)
* [리더보드에 상황 데이터 추가](/services/playfab/community/leaderboards/metadata-leaderboards)
* [API 참조](/services/playfab/community/leaderboards/api-reference)
* [Leaderboard meters](/services/playfab/pricing/meters/leaderboard-meters)
* [리더보드와 CloudScript](/services/playfab/community/leaderboards/leaderboards-cloudscript).
* [PlayStream과 함께 사용하는 리더보드](/services/playfab/community/leaderboards/leaderboards-with-playstream-and-telemetry)


## Related topics

- [Quota Leaderboards](/ko/services/playfab/community/leaderboards/quota-leaderboards.md)
- [PFLeaderboardsCreateLeaderboardDefinitionAsync](/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardscreateleaderboarddefinitionasync.md)
- [PFLeaderboardsLeaderboardEntityRankOnVersionEndConfig](/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboardentityrankonversionendconfig.md)
- [PFLeaderboardsLeaderboardDefinition](/ko/services/playfab/api-references/c/pfleaderboardstypes/structs/pfleaderboardsleaderboarddefinition.md)
- [PFLeaderboardsUpdateLeaderboardDefinitionAsync](/ko/services/playfab/api-references/c/pfleaderboards/functions/pfleaderboardsupdateleaderboarddefinitionasync.md)