osu-lazer/osu.Game/Online/API/Requests/GetUsersRequest.cs

// Copyright (c) ppy Pty Ltd <contact@ppy.sh>. Licensed under the MIT Licence.
// See the LICENCE file in the repository root for full licence text.

using System;
using osu.Game.Online.API.Requests.Responses;

namespace osu.Game.Online.API.Requests
{
    /// <summary>
    /// Looks up users with the given <see cref="UserIds"/>.
    /// In comparison to <see cref="LookupUsersRequest"/>, the response here contains <see cref="APIUser.RulesetsStatistics"/>,
    /// but in exchange is subject to more stringent rate limiting.
    /// </summary>
    public class GetUsersRequest : APIRequest<GetUsersResponse>
    {
        public readonly int[] UserIds;

        private const int max_ids_per_request = 50;

        public GetUsersRequest(int[] userIds)
        {
            if (userIds.Length > max_ids_per_request)
                throw new ArgumentException($"{nameof(GetUsersRequest)} calls only support up to {max_ids_per_request} IDs at once");

            UserIds = userIds;
        }

        protected override string Target => "users/?ids[]=" + string.Join("&ids[]=", UserIds);
    }
}