1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
|
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using Newtonsoft.Json;
namespace StardewModdingAPI.Toolkit.Framework.Clients.WebApi
{
/// <summary>Provides methods for interacting with the SMAPI web API.</summary>
public class WebApiClient
{
/*********
** Properties
*********/
/// <summary>The base URL for the web API.</summary>
private readonly Uri BaseUrl;
/// <summary>The API version number.</summary>
private readonly ISemanticVersion Version;
/*********
** Public methods
*********/
/// <summary>Construct an instance.</summary>
/// <param name="baseUrl">The base URL for the web API.</param>
/// <param name="version">The web API version.</param>
public WebApiClient(string baseUrl, ISemanticVersion version)
{
this.BaseUrl = new Uri(baseUrl);
this.Version = version;
}
/// <summary>Get the latest SMAPI version.</summary>
/// <param name="modKeys">The mod keys for which to fetch the latest version.</param>
public IDictionary<string, ModInfoModel> GetModInfo(params string[] modKeys)
{
return this.Post<ModSearchModel, Dictionary<string, ModInfoModel>>(
$"v{this.Version}/mods",
new ModSearchModel(modKeys, allowInvalidVersions: true)
);
}
/// <summary>Get the latest version for a mod.</summary>
/// <param name="updateKeys">The update keys to search.</param>
public ISemanticVersion GetLatestVersion(string[] updateKeys)
{
if (!updateKeys.Any())
return null;
// fetch update results
ModInfoModel[] results = this
.GetModInfo(updateKeys)
.Values
.Where(p => p.Error == null)
.ToArray();
if (!results.Any())
return null;
ISemanticVersion latest = null;
foreach (ModInfoModel result in results)
{
if (!SemanticVersion.TryParse(result.PreviewVersion ?? result.Version, out ISemanticVersion cur))
continue;
if (latest == null || cur.IsNewerThan(latest))
latest = cur;
}
return latest;
}
/*********
** Private methods
*********/
/// <summary>Fetch the response from the backend API.</summary>
/// <typeparam name="TBody">The body content type.</typeparam>
/// <typeparam name="TResult">The expected response type.</typeparam>
/// <param name="url">The request URL, optionally excluding the base URL.</param>
/// <param name="content">The body content to post.</param>
private TResult Post<TBody, TResult>(string url, TBody content)
{
// note: avoid HttpClient for Mac compatibility
using (WebClient client = new WebClient())
{
Uri fullUrl = new Uri(this.BaseUrl, url);
string data = JsonConvert.SerializeObject(content);
client.Headers["Content-Type"] = "application/json";
client.Headers["User-Agent"] = $"SMAPI/{this.Version}";
string response = client.UploadString(fullUrl, data);
return JsonConvert.DeserializeObject<TResult>(response);
}
}
}
}
|
