ArchiSteamFarm.CustomPlugins.ExamplePlugin/CatAPI.cs

   1 // ----------------------------------------------------------------------------------------------
   2 //     _                _      _  ____   _                           _____
   3 //    / \    _ __  ___ | |__  (_)/ ___| | |_  ___   __ _  _ __ ___  |  ___|__ _  _ __  _ __ ___
   4 //   / _ \  | '__|/ __|| '_ \ | |\___ \ | __|/ _ \ / _` || '_ ` _ \ | |_  / _` || '__|| '_ ` _ \
   5 //  / ___ \ | |  | (__ | | | || | ___) || |_|  __/| (_| || | | | | ||  _|| (_| || |   | | | | | |
   6 // /_/   \_\|_|   \___||_| |_||_||____/  \__|\___| \__,_||_| |_| |_||_|   \__,_||_|   |_| |_| |_|
   7 // ----------------------------------------------------------------------------------------------
   8 // |
   9 // Copyright 2015-2024 Łukasz "JustArchi" Domeradzki
  10 // Contact: JustArchi@JustArchi.net
  11 // |
  12 // Licensed under the Apache License, Version 2.0 (the "License");
  13 // you may not use this file except in compliance with the License.
  14 // You may obtain a copy of the License at
  15 // |
  16 // http://www.apache.org/licenses/LICENSE-2.0
  17 // |
  18 // Unless required by applicable law or agreed to in writing, software
  19 // distributed under the License is distributed on an "AS IS" BASIS,
  20 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  21 // See the License for the specific language governing permissions and
  22 // limitations under the License.
  23
  24 using System;
  25 using System.Collections.Immutable;
  26 using System.Linq;
  27 using System.Threading;
  28 using System.Threading.Tasks;
  29 using ArchiSteamFarm.Web;
  30 using ArchiSteamFarm.Web.Responses;
  31
  32 namespace ArchiSteamFarm.CustomPlugins.ExamplePlugin;
  33
  34 // This is example class that shows how you can call third-party services within your plugin
  35 // You've always wanted from your ASF to post cats, right? Now is your chance!
  36 // P.S. The code is almost 1:1 copy from the one I use in ArchiBot, you can thank me later
  37 internal static class CatAPI {
  38         private const string URL = "https://api.thecatapi.com";
  39
  40         internal static async Task<Uri?> GetRandomCatURL(WebBrowser webBrowser, CancellationToken cancellationToken = default) {
  41                 ArgumentNullException.ThrowIfNull(webBrowser);
  42
  43                 Uri request = new($"{URL}/v1/images/search");
  44
  45                 ObjectResponse<ImmutableList<MeowResponse>>? response = await webBrowser.UrlGetToJsonObject<ImmutableList<MeowResponse>>(request, cancellationToken: cancellationToken).ConfigureAwait(false);
  46
  47                 return response?.Content?.FirstOrDefault()?.URL;
  48         }
  49 }