CocApi 0.20.0-alpha

This is a prerelease version of CocApi.
There is a newer version of this package available.
See the version list below for details.
dotnet add package CocApi --version 0.20.0-alpha                
NuGet\Install-Package CocApi -Version 0.20.0-alpha                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="CocApi" Version="0.20.0-alpha" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add CocApi --version 0.20.0-alpha                
#r "nuget: CocApi, 0.20.0-alpha"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install CocApi as a Cake Addin
#addin nuget:?package=CocApi&version=0.20.0-alpha&prerelease

// Install CocApi as a Cake Tool
#tool nuget:?package=CocApi&version=0.20.0-alpha&prerelease                

CocApiLibrary

This .NET Standard 2.1 library will provide responses from developer.clashofclans.com.

CocApiConsoleTest

The test program shows you how to set up the library. The library can grab SC API objects on command. It can also automatically keep these objects up to date by polling the API. When an object changes, it will fire an event which you can subscribe to. You may optionally provide an ILogger to observe what the library is doing. The test program will output the following:<br/><br/> Test Program console output
If you choose to keep the objects up to date, the library will constantly write to the ILogger. Of course, the ILogger is in your program, so you can choose what to print.

CocApi

The CocApi class is the entry point to this library. You likely want this class to be a singleton that lives for the life of your application. This class is disposable, don't forget to call Dispose when you end your applicaiton. This program has the potential to consume a lot of memory.

CocApiConfiguration

Use this to configure the CocApi class. This class can control how often your SC API token is used. You can also control how long a downloaded object is considered good for. The default values are very conservative just in case the SC API key you provide is used for something else. This is to avoid rate limiting your key. If your key is only used in CocApi, you can make the time spans much shorter. The API allows about 10 requests a second per key.

WebResponse

This is an internal static class. If it prints to the ILogger, that indicates that the library is polling the API.

UpdateService

This is an internal class. If it prints to the ILogger, it is updating an object. If the object being updated is not expired, it will not ask the WebResponse class to poll the API.

ICurrentWarAPIModel

This interface is implemented by CurrentWarAPIModel and LeagueWarAPIModel. The only difference is LeagueWarAPIModel has a WarTag property, and the WarType enum will be SCCWL. When CocApi returns an ICurrentWarAPIModel, you can cast it to the appropriate type when necessary. LeagueWarAPIModel also inherits from CurrentWarAPIModel. If you have to cast, ensure you start with LeagueWarAPIModel.

IWar

This empty interface is implemented by ICurrentWarAPIModel and the NotInWar model. The library will never return an ICurrentWarAPIModel with state = notInWar.

ILeagueGroup

This empty interface is implemented by LeagueGroupApiModel and LeagueGroupNotFound. Clans that are not in CWL war will return a LeagueGroupNotFound.

Extensions

The static Extensions class contains some things that may be useful, especially for Discord bots. DiscordSafe will strip Discord markup characters from a given string. LeftToRight will force characters to display left to right. This is especially helpful while making tables. ToDateTime will convert SC API date time objects to C# DateTime, though the library already handles this when downloading your object.

Outages

When the API goes down, the IsAvailableChanged event will fire. CocApi will not stop trying to update expired objects unless you tell it to in this event. When an outage is detected, it will poll the API every five seconds to see if the server is back up. If an error occurs while watching clans, a CrashDetected event will fire. You may handle it by StartWatchingClans, or any other means you wish.

Issues

If you have problems finding one of the required nuget packages, add https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json as a source.</br></br> If the objects update too slow or two fast, modify the properties of the CocApiConfiguration. TokenObject rate limits are bad. TokenObject preemptive rate limits are okay, though it does indicate the library is updating as fast as the TokenTimeOut allows.

Entity Framework

These classes should translate to working tables with little or no effort. Paste the below code into your OnModelCreating.

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    //composite keys
    modelBuilder.Entity<ClanLabelAPIModel>().HasKey(p => new { p.Id,  p.ClanTag });
    modelBuilder.Entity<AchievementAPIModel>().HasKey(p => new { p.Name, p.VillageTag });
    modelBuilder.Entity<SpellAPIModel>().HasKey(p => new { p.Name, p.VillageTag });
    modelBuilder.Entity<TroopAPIModel>().HasKey(p => new { p.Name, p.VillageTag, p.Village });
    modelBuilder.Entity<LegendLeagueResultAPIModel>().HasKey(p => new { p.Id, p.VillageTag, p.Village });
    modelBuilder.Entity<VillageLabelAPIModel>().HasKey(p => new { p.Id, p.VillageTag });
    modelBuilder.Entity<AttackAPIModel>().HasKey(p => new { p.WarId, p.Order });

    //define one-to-zero(or one) relationship between villages and legends league
    modelBuilder.Entity<VillageAPIModel>()
                .HasOne(p => p.LegendStatistics)
                .WithOne(p => p!.Village!)
                .HasForeignKey<LegendLeagueStatisticsAPIModel>(p => p.VillageTag)
                .OnDelete(DeleteBehavior.Restrict);

    //define one-to-one relationship between current war and flags
    modelBuilder.Entity<CurrentWarAPIModel>()
        .HasOne(p => p.Flags)
        .WithOne(p => p.CurrentWarAPIModel)
        .HasForeignKey<CurrentWarFlagsModel>(p => p.WarId);
}

Disclaimer

This content is not affiliated with, endorsed, sponsored, or specifically approved by Supercell and Supercell is not responsible for it. For more information see Supercell's Fan Content Policy.

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.1 is compatible. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on CocApi:

Package Downloads
CocApi.Cache

Caches response from the Clash of Clans API.

CocApi.Rest

A wrapper for the Clash of Clans API

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.11.1 500 12/13/2023
2.5.0 881 5/28/2023
2.4.0 235 5/21/2023
2.0.0 575 5/7/2023
2.0.0-preview1.17.9 107 1/19/2023
2.0.0-preview1.17.4 135 10/9/2022
2.0.0-preview1.17.2 103 10/5/2022
2.0.0-preview1.14.7 131 5/7/2022
2.0.0-preview1.14.1 105 5/1/2022
2.0.0-preview1.14.0 113 5/1/2022
1.14.6 360 12/11/2021
1.14.5 335 10/24/2021
1.14.4 379 10/8/2021
1.14.3 412 10/6/2021
1.14.2 402 9/30/2021
1.14.1 345 9/25/2021
1.14.0 388 9/25/2021
1.13.0 361 9/18/2021
1.12.0 463 9/11/2021
1.11.5 450 9/11/2021
1.11.4 446 7/17/2021
1.11.3 360 7/14/2021
1.11.2 358 7/14/2021
1.11.1 371 7/14/2021
1.11.0 374 7/14/2021
1.10.3 360 7/11/2021
1.10.2 385 6/23/2021
1.10.1 388 6/17/2021
1.10.0 372 6/16/2021
1.9.1 412 5/2/2021
1.9.0 402 5/2/2021
1.8.0 432 4/25/2021
1.7.1 357 4/13/2021
1.7.0 357 4/10/2021
1.6.0 386 4/8/2021
1.5.2 366 4/12/2021
1.5.1.1 383 3/14/2021
1.5.1 331 3/13/2021
1.5.0.2 354 3/10/2021
1.5.0.1 379 2/28/2021
1.5.0 360 2/20/2021
1.4.0.1 374 2/17/2021
1.4.0 466 2/7/2021
1.4.0-preview.1.1.0.0 169 1/25/2021
1.4.0-preview.1.0.0.0 180 1/24/2021
1.3.2-preview.1.0.1.7 248 1/2/2021
1.3.2-preview.1.0.1.5 228 1/1/2021
1.3.2-preview.1.0.1.4 294 1/1/2021
1.3.2-preview.1.0.1.2 182 12/27/2020
1.3.2-preview.1.0.1.1 196 12/26/2020
1.3.2-preview.1.0.1 214 12/14/2020
1.3.2-preview.1.0.0.1 219 12/26/2020
1.3.2-preview.1.0.0 242 12/13/2020
1.3.1.4 646 12/13/2020
1.3.1.3 659 12/12/2020
1.3.1.2 631 12/12/2020
1.3.1.1 678 12/12/2020
1.3.1 528 12/12/2020
1.3.0 563 12/12/2020
1.2.0 601 12/11/2020
1.1.1.5 643 12/9/2020
1.1.1.4 578 12/8/2020
1.1.1 1,052 12/6/2020
1.1.0 685 12/5/2020
1.0.0 588 11/26/2020
0.43.0-alpha 402 5/25/2020
0.42.0-alpha 348 5/20/2020
0.41.0-alpha 421 5/18/2020
0.40.0-alpha 333 5/12/2020
0.39.0-alpha 348 5/12/2020
0.38.0-alpha 379 5/11/2020
0.37.0-alpha 342 5/9/2020
0.36.0-alpha 361 5/8/2020
0.35.0-alpha 344 5/8/2020
0.34.0-alpha 337 5/7/2020
0.33.0-alpha 361 5/6/2020
0.32.0-alpha 366 5/5/2020
0.31.0-alpha 329 5/5/2020
0.30.0-alpha 344 5/3/2020
0.29.0-alpha 347 4/19/2020
0.28.0-alpha 343 4/19/2020
0.27.0-alpha 245 4/19/2020
0.26.0-alpha 319 3/18/2020
0.25.0-alpha 326 2/23/2020
0.24.0-alpha 330 1/26/2020
0.23.0-alpha 275 1/7/2020
0.22.0-alpha 257 1/5/2020
0.21.0-alpha 268 12/15/2019
0.20.0-alpha 251 11/27/2019
0.19.0-alpha 268 11/24/2019
0.18.0-alpha 286 11/23/2019
0.17.0-alpha 255 11/11/2019

Initial Release

https://dotnetfeed.blob.core.windows.net/dotnet-core/index.json
Use this feed to get Reflection while this is in prerelease.