如何为此 API (Kotlin-Retrofit) 创建 model？

Question

我正在使用https://www.api-football.com来获取足球国家和联赛，Json 对国家/地区的响应是这样的：

{
"get": "countries",
"parameters": [],
"errors": [],
"results": 164,
"paging": {
    "current": 1,
    "total": 1
},
"response": [
    {
        "name": "Albania",
        "code": "AL",
        "flag": "https://media.api-sports.io/flags/al.svg"
    },
    {
        "name": "Algeria",
        "code": "DZ",
        "flag": "https://media.api-sports.io/flags/dz.svg"
    },
    {
        "name": "Andorra",
        "code": "AD",
        "flag": "https://media.api-sports.io/flags/ad.svg"
    },
    

    ...

我尝试像这样创建 model：

这是CountryData数据 class：

data class CountryData (
val code: String,
val flag: String,
val name: String
)

这是使用 CountryData 并在列表中使用它们的Country数据 class：

data class Country(
val results : List<CountryData>
)

But those models give me some errors: com.google.gson.JsonSyntaxException: java.lang.IllegalStateException: Expected BEGIN_ARRAY but was NUMBER at line 1 column 61 path $.results

我认为这是因为 api 响应类型不是CountryData的列表。

因此，如果这是问题所在，我只想获得"response": [...但我不知道该怎么做。

如果您认为其他问题导致此错误，请告诉我。

对了，这里是api接口：

interface FootballApi {

@Headers("X-RapidAPI-Key: $API_KEY")
@GET(GET_COUNTRIES)
suspend fun getCountries() : Response<Country>
}

这是我的 Retrofit 实例：

object RetrofitInstance {

val api: FootballApi by lazy {
    Retrofit.Builder()
        .baseUrl(BASE_URL)
        .addConverterFactory(GsonConverterFactory.create())
        .build()
        .create(FootballApi::class.java)
}
}

Answer 1

我通过在我的项目中添加其他数据模型解决了这个问题。 这是Country数据 class：

data class Country(
val code: String,
val flag: String,
val name: String
)

这是CountryResponse数据 class：

data class CountryResponse (
val get: String,
val parameters: List<Any>,
val errors: List<Any>,
val results: Int,
val paging: Paging,
val response: List<Country>
)

这是Paging数据 class：

data class Paging(
val current: Int,
val total: Int
)

现在我可以通过response.body().!.response获取国家/地区列表

Answer 2

您首先遇到的问题是 model 中的参数名称很重要：起初您尝试将 JSON 数据解组到错误的模型中：

data class Country(
val results : List<CountryData>
)

包含所有国家/地区的 JSON 字段的名称response如下：

"response": [
    {
        "name": "Albania",
        "code": "AL",
        "flag": "https://media.api-sports.io/flags/al.svg"
    },
    ...

因此，如果您在 model 中使用相同的属性，则无需将所有其他属性（您可能不需要）添加到 model 即可工作：

data class Country(
val response: List<CountryData>
)