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 esitetty.
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äsitellä saatuja tietoja oikein.
Esimerkkejä Content-Type-otsikkokentistä ovat:
- text/html: Tämä tarkoittaa, että vastauksen sisältö on HTML-muodossa, joka voidaan näyttää selaimessa.
- application/json: Vastauksen sisältö on JSON-muodossa, joka on yleinen tapa välittää dataa selaimen ja palvelimen välillä.
- image/png: Vastauksen sisältö on PNG-kuvatiedosto.
- 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äsitellä 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.