/// <summary>
/// Create a permissions builder instance that masks the emitted scopes to exclude any scopes not
/// contained in the list of scopes already granted for the given API Key the <paramref name="client"/> was initialized with.
/// </summary>
/// <param name="client">The SendGrid client.</param>
/// <returns>A <see cref="SendGridPermissionsBuilder"/> instance.</returns>
public static async Task <SendGridPermissionsBuilder> CreateMaskedPermissionsBuilderForClient(this ISendGridClient client)
{
var response = await client.RequestAsync(method : SendGridClient.Method.GET, urlPath : "scopes");
var body = await response.DeserializeResponseBodyAsync();
var userScopesJArray = (body["scopes"] as JArray);
var includedScopes = userScopesJArray.Values <string>().ToArray();
var builder = new SendGridPermissionsBuilder();
builder.Exclude(scope => !includedScopes.Contains(scope));
return(builder);
}
/// <summary>
/// Create a new API key for the scopes contained in the <paramref name="permissions"/>.
/// </summary>
/// <param name="client">The SendGrid client.</param>
/// <param name="permissions">The permissions builder.</param>
/// <param name="name">The API key name.</param>
/// <returns>The <see cref="Response"/> from the SendGrid API call.</returns>
public static async Task <Response> CreateApiKey(this ISendGridClient client, SendGridPermissionsBuilder permissions, string name)
{
var scopes = permissions.Build();
var payload = new
{
name,
scopes
};
var data = JsonConvert.SerializeObject(payload);
var response = await client.RequestAsync(method : SendGridClient.Method.POST, urlPath : "api_keys", requestBody : data);
return(response);
}