ohjeet.txt

Luo sovellukselle kansio. Mene kansioon komentorivillä.
Anna komennot:

python -m venv venv

venv\scripts\activate

pip install fastapi[standard]
pip install sqlalchemy
Jos haluat käyttää postgreSQL:ää, lisäksi:
pip install psycopg2-binary

pip freeze > requirements.txt #tallettaa kuuluvat kirjastot luettelona

Lisää sitten tässä repossa olevan kaltainen server.py tiedosto projektiin,
sekä myös .gitignore samalla tavalla kuin tässä repossa ja samoilla sisällöillä.

Suorittaminen:

Kun ajat komennon
uvicorn main:app --reload
niin oletusosoite on:
http://127.0.0.1:8000

Jos haluaa ottaa yhteyden toiselta koneelta aja:
uvicorn main:app --host 0.0.0.0 --port 8000 --reload

Silloin palvelin vastaa osoitteessa http://koneen-ip-osoite:8000/phonebook
ipv4 osoite on muotoa 192.169.50.114 esimerkiksi.
Sen saa selville kun kirjoittaa ipconfig -komennon komentorivillä.

--- "SWAGGER" / Open API -------

FastAPI tekee OpenAPI-skeeman automaattisesti, kun sinulla on app = FastAPI().
Eli sinun ei tarvitse erikseen asentaa mitään lisää – se on sisäänrakennettuna.

Kun käynnistät palvelimen (uvicorn main:app --reload), saat nämä:

OpenAPI JSON:
http://127.0.0.1:8000/openapi.json

(Tämä on se koneystävällinen OpenAPI 3.0 -määrittely)

Swagger UI (interaktiivinen käyttöliittymä):
http://127.0.0.1:8000/docs

ReDoc-dokumentaatio:
http://127.0.0.1:8000/redoc