# Ország / Város API

[vissza az API indexhez](./index.md)

## Országlista lekérése

`GET /api/countries/` - private api

`GET /countries/` - public api

```json
{
  "AF": "Afghanistan",
  "AL": "Albania",
  "DZ": "Algeria",
  "AD": "Andorra",
  "AO": "Angola",
  ...
}
```

## Városlista lekérdezése országkód alapján

`GET /api/cities/<2 betűs országkód>/` - private api

`GET /cities/<2 betűs országkód>/` - public api

Lekéri egy országhoz tartozó városokat és egy JSON tömbbel tér vissza. Az országot az URL legutolsó paramétereként kell átadni, kis-/nagybetű nem számít. Például:

> GET /api/cities/hu/

```json
[
  "Aba",
  "Abádszalók",
  "Abasár",
  "Abaújszántó",
  "Abda",
  "Abony",
  ...
]
```

Ha nem létező országkódot adunk meg, akkor 404-et dob az api.

`GET /api/cities/<2 betűs országkód>/?autocomplete=<keresés>`

Egy országhoz tartozó város listájában lehet keresni a keresés mező alapján, amelyik a városnevek elejével egyező találatokra szűr. Ha a keresés mező üres, akkor minden találatot visszaad. A keresés mezőnél kis-/nagybetű nem számít. Például:

> GET /api/cities/hu/autocomplete/bud

```json
["Budakalász", "Budakeszi", "Budaörs", "Budapest"]
```