Content-Type

Content-Type on HTTP-vastauksen (response) ja joskus myös HTTP-pyynnön (request) otsikkokenttä

Content-Type joka kertoo vastauksen sisällön tai pyynnön lähettämän tiedon mediatyypin (MIME-tyypin). Se määrittelee, millaisessa formaatissa vastauksen tai pyynnön tieto on eonlinetty.

HTTP-palvelin käyttää merkintä-otsikkokenttää vastauksessa ilmoittamaan asiakasohjelmalle (yleensä verkkoselaimelle), millä tavalla vastauksen sisältö on muotoiltu. Merkintä on tärkeä otsikkokenttä, sillä ilman sitä asiakasohjelma ei tiedä, miten käonlinellä saatuja tietoja oikein.

Esimerkkejä Content-Type-otsikkokentistä ovat:

1. text/html: Tämä tarkoittaa, että vastauksen sisältö on HTML-muodossa, joka voidaan näyttää selaimessa.
2. application/json: Vastauksen sisältö on JSON-muodossa, joka on yleinen tapa välittää dataa selaimen ja palvelimen välillä.
3. image/png: Vastauksen sisältö on PNG-kuvatiedosto.
4. application/pdf: Vastauksen sisältö on PDF-muodossa.

Merkintä määrittää, miten vastauksen sisältö tulee tulkita ja näyttää asiakasohjelmassa. Jos esimerkiksi vastauksen merkintä on ”text/html”, selain tietää, että se voi näyttää vastauksen HTML-muodossa ja renderoida sen oikein käyttäjälle. Jos taas Content-Type on ”application/json”, selain tietää, että vastauksen sisältö on JSON-muodossa, ja se voi käonlinellä tiedot oikein JSON-parserin avulla.

Vastaavasti, jos HTTP-pyynnössä on merkintä otsikkokenttä, se kertoo palvelimelle, millaisessa formaatissa pyynnön mukana oleva data on. Esimerkiksi POST-pyynnössä, jossa lähetetään lomakkeen tiedot, Content-Type-otsikkokenttä voi olla ”application/x-www-form-urlencoded”, joka kertoo, että lomakkeen tiedot on koodattu URL-muotoon. Tai jos pyynnön mukana lähetetään JSON-dataa, merkintä voi olla ”application/json”.

Merkintä on siis tärkeä otsikkokenttä, joka mahdollistaa tiedon oikeanlaisen käsittelyn ja esittämisen selaimessa tai muussa asiakasohjelmassa.

HTTP-pyyntö (request)

HTTP-pyyntö (HTTP request) on viesti, jonka asiakasohjelma, kuten verkkoselain, lähettää palvelimelle tietyn toiminnon suorittamiseksi. Tämä toiminto voi olla esimerkiksi verkkosivun hakeminen, tiedon lähettäminen palvelimelle tai resurssin poistaminen.

HTTP-pyynnössä on yleensä seuraavat osat:

HTTP-metodi: Määrittää, mitä toimintoa pyydetään suoritettavaksi. Yleisimpiä metodeja ovat GET (hakeminen), POST (tietojen lähettäminen), PUT (resurssin päivittäminen), DELETE (resurssin poistaminen) ja muut.

URI (Uniform Resource Identifier): Osoittaa pyynnön kohteen, esimerkiksi verkkosivun URL-osoitteen.

HTTP-otsakkeet (Headers): Tarjoavat lisätietoa pyynnöstä, kuten käyttäjäagentin tiedot, hyväksytyt kielet, evästeet jne.

Mahdollinen pyyntösisältö (Request body): On käytössä esimerkiksi POST-pyynnöissä, joissa dataa lähetetään palvelimelle.

Esimerkki HTTP-pyynnöstä:

POST /api/user/create HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 43

{"username": "example", "password": "1234"}

Tässä esimerkissä:

Metodi on POST, mikä tarkoittaa, että käyttäjä haluaa luoda uuden käyttäjän. URI on ”/api/user/create”, mikä osoittaa resurssin, johon pyyntö kohdistuu. Otsakkeissa on määritelty muun muassa palvelimen nimi, sisällön tyyppi ja pituus.

Pyyntösisältössä on käyttäjän antamat tiedot JSON-muodossa.

HTTP-pyyntö (request)

HTTP-pyyntö (HTTP request) on viesti, jonka asiakasohjelma lähettää palvelimelle tietyn toiminnon suorittamiseksi verkkoyhteyden välityksellä. Tämä toiminto voi olla esimerkiksi verkkosivun hakeminen, tiedon lähettäminen palvelimelle tai resurssin päivittäminen.

HTTP-pyynnössä on tiettyjä osia, jotka määrittelevät pyynnön luonteen ja sisällön

HTTP-metodi: Määrittää, mitä toimintoa pyydetään suorittamaan palvelimella. Yleisimpiä metodeja ovat GET, POST, PUT, DELETE ja PATCH.
URI (Uniform Resource Identifier): Osoittaa resurssin, johon pyyntö kohdistuu. Tämä voi olla esimerkiksi verkkosivun URL-osoite.

HTTP-otsakkeet (Headers): Antavat lisätietoa pyynnöstä, kuten käyttäjäagentin tiedot, hyväksytyt kielet, evästeet ja muut metatiedot.

Pyynnön sisältö (Request body): On käytössä tietyissä pyynnöissä, kuten POST- tai PUT-pyynnöissä, kun dataa lähetetään palvelimelle esimerkiksi lomakkeen kautta.

Esimerkki HTTP-pyynnöstä:

POST /api/user/create HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 43

{"username": "käyttäjänimi", "password": "salasana"}

Tässä esimerkissä:

Metodi on POST, mikä tarkoittaa, että käyttäjä haluaa lähettää palvelimelle uuden käyttäjän luomiseen liittyvän pyynnön.

URI on ”/api/user/create”, mikä osoittaa resurssin, johon pyyntö kohdistuu.

Otsakkeissa on määritelty muun muassa palvelimen nimi, sisällön tyyppi ja pituus.

Pyynnön sisältö (Request body) on JSON-muotoinen data, joka sisältää käyttäjän antamat tiedot, kuten käyttäjänimen ja salasanan.