2024-01-19 API Pamati

[Rozkalns]

Part 1: Intro API izsaukumos un JSON

Pārskats par APIs un HTTP

"API" (Application Programming Interface)

• Definition: A set of rules that allows one software application to interact with another.

Resursi:
https://programmesana2.lv/api/zinasanu-kratuve
https://data.gov.lv/

Uzdevums:

Iegūt vidējo gaisa temperatūru Liepājā 1. jūnijā
Expectd result: 10.6375

Resources:

• Meteoroloģiskās stacijas: 79e707d8-6719-49b2-92b1-ec261451f1d9
• Meteoroloģiskie arhīva dati: ecc62e27-2071-483c-bca9-5e53d979faa8

Todo:

1. veikt izsaukumu uz staciju endpointu, dabūt Liepājas stacijas ID
2. veikt izsaukumu uz arhīvu ar parametriem: stacijas id, TDRY, 2023-06-01

Base URL: https://data.gov.lv/dati/lv/api/3/action/datastore_search

Tagad izmantojam: file_get_contents();

[Rozkalns]

Piegājiens API izmantošanai (nav parāk daudz OOP) -
Pirms OOP

Te ar uzlaboto versiju, ienestu klasēs
Pēc OOP refactor

Galvenais kam pievērst uzmanību:

1. Kļūdu apstrāde
2. Constructor injection, tā saucamais Composition (nevis Inheritance)
3. Filtru klases - labs veids, kā iekapsulēt filtrēšanas loģiku. Skaidri norāda, kādi parametri ir nepieciešami datu filtrēšanai
4. Read only klases - piesargā datus tā, lai tos nevarētu kļūdas pēc labot.