*이 콘텐츠는 AI(베타)를 사용해 번역되었으며, 오류가 있을 수 있습니다. 이 페이지를 영어로 보려면 여기를 클릭하세요.

GroupJoinRequest

그룹에 참여하는 요청.

권한 acceptRequests가 필요합니다.

특성

pathstring

그룹 조인 요청의 리소스 경로.

형식: groups/{group_id}/join-requests/{group_join_request_id}.

createTimestring
출력 전용

그룹 조인 요청이 생성된 타임스탬프. 이 문자열은 Timestamp 형식으로 지정됩니다.

userstring
출력 전용

사용자의 리소스 경로.

기본 URL

https://apis.roblox.com
GroupJoinRequest 리소스

{
"path": "groups/123/join-requests/123",
"createTime": "2023-07-05T12:34:56Z",
"user": "users/156"
}

GroupJoinRequest

그룹 조인 요청 목록
베타

GET /cloud/v2/groups/{group_id}/join-requests

그룹 아래에서 목록 조인 요청을 나열합니다.

범위
group:read
한도
  • API 키: 사용자 또는 그룹의 모든 API 키에 분당 요청 300건
  • OAuth 2.0: 앱 사용자당 분당 요청 90건

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. 속도 제한에 대해서 자세히 알아보세요.

요청경로 매개 변수
group_idstring
필수

그룹 ID.

쿼리 매개 변수
maxPageSizenumber

반환할 그룹 조인 요청 최대 수.서비스는 이 값보다 적은 값을 반환할 수 있습니다.지정되지 않으면 최대 10개의 그룹 조인 요청이 반환됩니다.최대 값은 20이고 더 높은 값은 20으로 설정됩니다.

pageTokenstring

이전 호출에서 받은 페이지 토큰으로, 이후 페이지를 검색합니다.

페이징할 때 후속 호출에 제공된 모든 다른 매개변수는 페이지 토큰을 제공한 호출과 일치해야 합니다.

filterstring

이 필드는 반환된 리소스를 필터링하기 위해 설정될 수 있습니다.

필터링은 공통 표현 언어(CEL)에 부합합니다. 단지 user 필드와 == 연산자만 지원됩니다.

예: "user == 'users/156'".

응답

부모 컬렉션의 GroupJoinRequests 목록.

nextPageTokenstring

다음 페이지를 검색하기 위해 pageToken 매개변수로 보낼 수 있는 토큰입니다. 이 필드가 생략되면 후속 페이지가 없습니다.

GET /cloud/v2/groups/{group_id}/join-requests

curl -L -X GET 'https://apis.roblox.com/cloud/v2/groups/{group_id}/join-requests?maxPageSize=10&pageToken={string}&filter={string}' \
-H 'x-api-key: {your-api-key}'
응답

{
"groupJoinRequests": [
{
"path": "groups/123/join-requests/123",
"createTime": "2023-07-05T12:34:56Z",
"user": "users/156"
}
],
"nextPageToken": "string"
}

GroupJoinRequest

그룹 가입 요청 수락
베타

POST /cloud/v2/groups/{group_id}/join-requests/{join_request_id}:accept

조인 요청을 수락합니다.

범위
group:write
한도
  • API 키: 사용자 또는 그룹의 모든 API 키에 분당 요청 100건
  • OAuth 2.0: 앱 사용자당 분당 요청 90건

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. 속도 제한에 대해서 자세히 알아보세요.

요청경로 매개 변수
group_idstring
필수

그룹 ID.

join_request_idstring
필수

조인 요청 ID.

요청 본문
POST /cloud/v2/groups/{group_id}/join-requests/{join_request_id}:accept

curl -L -X POST 'https://apis.roblox.com/cloud/v2/groups/{group_id}/join-requests/{join_request_id}:accept' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{}'

GroupJoinRequest

그룹 가입 요청 거절
베타

POST /cloud/v2/groups/{group_id}/join-requests/{join_request_id}:decline

가입 요청을 거절합니다.

범위
group:write
한도
  • API 키: 사용자 또는 그룹의 모든 API 키에 분당 요청 100건
  • OAuth 2.0: 앱 사용자당 분당 요청 90건

참고: 트래픽이 많은 기간에는 속도 제한이 더 낮아질 수 있습니다. 일부 엔드포인트에는 속도 제한이 추가로 적용됩니다. 속도 제한에 대해서 자세히 알아보세요.

요청경로 매개 변수
group_idstring
필수

그룹 ID.

join_request_idstring
필수

조인 요청 ID.

요청 본문
POST /cloud/v2/groups/{group_id}/join-requests/{join_request_id}:decline

curl -L -X POST 'https://apis.roblox.com/cloud/v2/groups/{group_id}/join-requests/{join_request_id}:decline' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{}'