Unduhan StromGedacht.NET - Unduhan kode sumber StromGedacht.NET

StromGedacht.NET

Pembangun Kekuatan

v1.1.0

Unduh

StromGedacht.NET

Klien C# untuk API StromGedacht

Instalasi

Tersedia di NuGet.

dotnet add package StromGedacht.NET

atau

PM > Install-Package StromGedacht.NET

Penggunaan

Klien dapat memberikan negara bagian wilayah pada waktu saat ini atau semua negara bagian untuk jangka waktu tertentu.

Jangka waktunya dapat diperpanjang maksimal 2 hari ke depan dan 4 hari ke belakang.

Setiap kali Anda membuat permintaan, Anda harus memberikan kode pos wilayah yang negara bagiannya ingin Anda minta.

Inisialisasi

Pertama buat instance StromGedachtClient dengan meneruskan instance HttpClient ke konstruktornya.

 var httpClient = new HttpClient ( ) ;

var client = new StromGedachtClient ( httpClient ) ;

Dapatkan keadaan saat ini

Anda dapat mengambil status suatu wilayah saat ini dengan memanggil metode Now / NowAsync dan meneruskan kode pos wilayah tersebut.

 var state = client . Now ( "70173" ) ;

 var state = await client . NowAsync ( "70173" ) ;

Jika api mengembalikan kesalahan, metode ini mengembalikan null . Hal ini dapat terjadi jika kode pos tidak valid/tidak didukung.

Dapatkan status untuk jangka waktu tertentu

Anda dapat mengambil semua negara bagian suatu wilayah untuk jangka waktu tertentu dengan memanggil metode States / StatesAsync dan meneruskan kode pos wilayah tersebut, waktu mulai dan waktu berakhir.

Waktu mulai dan berakhir dapat berupa dua tanggal:

 var from = new DateTimeOffset ( 2023 , 1 , 1 , 0 , 0 , 0 , TimeSpan . FromHours ( 2 ) ) ;
var to = new DateTimeOffset ( 2023 , 1 , 3 , 23 , 59 , 59 , TimeSpan . FromHours ( 2 ) ) ;

var states = client . States ( "70173" , from , to ) ;

 var from = new DateTimeOffset ( 2023 , 1 , 1 , 0 , 0 , 0 , TimeSpan . FromHours ( 2 ) ) ;
var to = new DateTimeOffset ( 2023 , 1 , 3 , 23 , 59 , 59 , TimeSpan . FromHours ( 2 ) ) ;

var states = await client . StatesAsync ( "70173" , from , to ) ;

atau jam relatif terhadap momen ini:

 var hoursInPast = 24 ;
var hoursInFuture  = 48 ;

var states = client . States ( "70173" , hoursInPast , hoursInFuture ) ;

 var hoursInPast = 24 ;
var hoursInFuture  = 48 ;

var states = await client . StatesAsync ( "70173" , hoursInPast , hoursInFuture ) ;

Jika api mengembalikan kesalahan, metode ini mengembalikan daftar kosong. Hal ini dapat terjadi jika kode pos tidak valid/tidak didukung atau jangka waktu yang didukung terlampaui.

Dapatkan ramalan cuaca

Anda dapat mengambil perkiraan suatu wilayah untuk jangka waktu tertentu dengan memanggil metode Forecast / ForecastAsync dan meneruskan kode pos wilayah tersebut, waktu mulai dan waktu berakhir.

 var from = new DateTimeOffset ( 2023 , 1 , 1 , 0 , 0 , 0 , TimeSpan . FromHours ( 2 ) ) ;
var to = new DateTimeOffset ( 2023 , 1 , 3 , 23 , 59 , 59 , TimeSpan . FromHours ( 2 ) ) ;

var forecast = client . Forecast ( "70173" , from , to ) ;

 var from = new DateTimeOffset ( 2023 , 1 , 1 , 0 , 0 , 0 , TimeSpan . FromHours ( 2 ) ) ;
var to = new DateTimeOffset ( 2023 , 1 , 3 , 23 , 59 , 59 , TimeSpan . FromHours ( 2 ) ) ;

var forecast = await client . ForecastAsync ( "70173" , from , to ) ;

Injeksi Ketergantungan

Anda dapat mendaftarkan StromGedachtClient di Startup Anda dengan mengetikkan HttpClient .

 builder . Services . AddHttpClient < StromGedachtClient > ( ) ;

Kemudian suntik klien dimanapun Anda suka. Misalnya di pengontrol:

 [ Route ( "Home" ) ]
[ ApiController ]
public class HomeController : ControllerBase
{
    private readonly StromGedachtClient _client ;

    public HomeController ( StromGedachtClient client )
    {
        _client = client ;
    }
}