class: center, middle, inverse

# Consumir Api
### Ktor client

---
<h3 class="alert-heading">Llicència</h3>
<p>Pots copiar i redistribuir aquest material seguint la llicència Attribution-NonCommercial-ShareAlike 4.0 International <a href="https://creativecommons.org/licenses/by-nc-sa/4.0/">CC BY-NC-SA 4.0</a>, indicant-ne autors originals, l'origen (aquesta web), sense fins comercials i mantenint-ne aquesta la llicència</p>
<p class="mb-0">Autors:</p>
<ul><li><a href="https://fp.mateuyabar.com">Mateu</a></li><li><a href="https://centellas.gitlab.io/teachingSite">Laura Centellas</a></li></ul>

---
# Consume Api
- Podem llegir un json d'internet
	- API - Exemple: https://opendata-ajuntament.barcelona.cat/resources/bcn/Arbrat/OD_Arbrat_Zona_BCN.json
- Utilitzarem el Ktor-client

---
# Gradle
Per poder fer servir el ktor-client ens cal declarar les dependències següents:
```
dependencies {
    implementation("io.ktor:ktor-client-core:2.1.0")
    implementation("io.ktor:ktor-client-cio:2.1.0")
    implementation("io.ktor:ktor-client-content-negotiation:2.1.0")
    implementation("io.ktor:ktor-serialization-kotlinx-json:2.1.0")
}
```

---
# Serializable - APi
```kotlin
@Serializable
data class BcnTree(
    @SerialName("nom_cientific") val scientificName : String,
    @SerialName("nom_catala") val name: String?,
    @SerialName("adreca") val adress: String
)

```
---
# ktor-client

```
suspend fun main(){
    val client = HttpClient(CIO){
        install(ContentNegotiation) {
            json(Json {
                ignoreUnknownKeys = true
            })
        }
    }
    val trees : List<BcnTree> = client.get("https://opendata-ajuntament.barcelona.cat/resources/bcn/Arbrat/OD_Arbrat_Zona_BCN.json").body()
    println("There are ${trees.size} in Barcelona")
    println("Example ${trees.first()}")
}
```