如何在 Kotlin 中调用这个 API？

Question

我正在尝试调用这个API： https://dog-facts-api.herokuapp。 com/api/v1/resources/dogs?number=2

如您所见，它返回一个 Json，其中包含有关狗的随机事实， 我的问题是当我将我的baseUrl与retrofit一起放置时：

private fun getRetrofit(): Retrofit{
        return Retrofit.Builder()
            .baseUrl("https://dog-facts-api.herokuapp.com/api/v1/resources/dogs?number=")
            .addConverterFactory(GsonConverterFactory.create())
            .build()
    }

如果我像这样放置url，它就不起作用，因为它说必须以“/”结尾 但如果我添加它，它就不起作用了。

另外，我尝试这样写：

.baseUrl("https://dog-facts-api.herokuapp.com/api/v1/resources/")

并像这样进行调用：

val call = getRetrofit().create(APIService::class.java).getFactsByNumber("dogs?number=$number")

但同样，它不起作用，它会抛出错误：

E/AndroidRuntime: FATAL EXCEPTION: DefaultDispatcher-worker-1 进程：com.eltonga.dogfacts，PID：11927 com.google.gson.JsonSyntaxException：java.lang.IllegalStateException：预期为 BEGIN_OBJECT，但在第 1 行第 2 列路径处为 BEGIN_ARRAY $

我的接口：

interface APIService {
    @GET
    suspend fun getFactsByNumber(@Url url: String): Response<FactsResponse>
}

我的数据类：

data class FactsResponse(var fact: List<String>)

我调用 API 的函数：

private fun searchByNumber(number:Int){
        CoroutineScope(Dispatchers.IO).launch {
            val call = getRetrofit().create(APIService::class.java).getFactsByNumber("dogs?number=$number")
            val the_facts = call.body()

            runOnUiThread {
                if(call.isSuccessful){
                    val factsData = the_facts?.fact ?: emptyList()
                    facts.clear()
                    facts.addAll(factsData)
                    adapter.notifyDataSetChanged()
                }else{
                    Toast.makeText(binding.btnGo.context, "Error", Toast.LENGTH_SHORT).show()
                }
            }

        }
    }

我能做什么？我对 API 工作还很陌生

Answer 1

预期为 BEGIN_OBJECT，但结果为 BEGIN_ARRAY

上述错误表明 API 响应的根部有一个数组/列表，并且您正尝试将响应反序列化为以下对象：不是数组/列表。

interface APIService {
    @GET
    suspend fun getFactsByNumber(@Url url: String): Response<FactsResponse>
}

data class FactsResponse(var fact: List<String>)

如果响应采用以下格式，这将起作用

{
  "fact": [
    "Greyhounds can reach a speed of up to 45 miles per hour.",
    "The average dog can run about 19 mph. Greyhounds are the fastest dogs on Earth and can run at speeds of 45 mph."
  ]
}

但是由于响应采用以下格式，

[
  {
    "fact": "Greyhounds can reach a speed of up to 45 miles per hour."
  },
  {
    "fact": "The average dog can run about 19 mph. Greyhounds are the fastest dogs on Earth and can run at speeds of 45 mph."
  }
]

您需要将返回类型用 List 包装，并且该类应该只有一个 fact< /code> 字符串字段。因此函数和数据类应该定义为

interface APIService {
    @GET
    suspend fun getFactsByNumber(@Url url: String): Response<List<FactsResponse>>
}

data class FactsResponse(val fact: String)

另外，定义接口函数以避免每次传递它 "dogs?number=$number" 的更好方法是

interface APIService {
    @GET("dogs")
    suspend fun getFactsByNumber(@Query("number") number: String): Response<List<FactsResponse>>
}

并将函数调用为

val apiService = getRetrofit().create(APIService::class.java)

val call = apiService.getFactsByNumber(number) // where number is already defined and initialized with a value