Miten välityspalvelin käsittelee mukautettua API-otsikkoa

API voi kantaa versionsa mukautetussa pyyntökentässä, esimerkiksi API-Version. Tavallisen edelleenlähettävän välityspalvelimen ei pitäisi hylätä tuota kenttää vain siksi, että nimi on tuntematon. HTTP edellyttää tuntemattomien kenttien edelleenlähettämistä, ellei määriteltyä poikkeusta tai määritettyä käytäntöä sovelleta.

Connection-kenttä on yksi tällainen poikkeus. Vertaa näitä esimerkkipyyntöjä:

API-Version: 2026-10
Connection: keep-alive

Tässä API-kenttää ei ole merkitty tälle yhteydelle paikalliseksi. Seuraavassa esimerkissä lähettäjä muuttaa sen laajuutta nimenomaisesti:

API-Version: 2026-10
Connection: API-Version

Edelleenlähettävä välityspalvelin poistaa Connectionin nimeämät kentät ennen edelleenlähetystä ja poistaa tai korvaa itse yhteydenkohtaiset ohjeet. Siksi alkuperälle tarkoitettu sovellusotsikko ei saisi näkyä tuossa tunnisteluettelossa.

Etsi kohta, jossa kenttä muuttuu

Vertaa asiakkaan rakentamaa pyyntöä, välityspalvelimen vastaanottamia ja edelleenlähettämiä kenttiä sekä sitä, mitä alkuperä vastaanotti. Asiakas voi jättää otsikon pois ennen kuin välityspalvelin näkee sen; määritetty suodatin voi poistaa sen tarkoituksella; palvelin voi hylätä pyynnön otsikkorajan ylityksen vuoksi.

Älä päättele hiljaista poistoa pelkästään vanhassa käyttöönotossa raportoidusta otsikon kokorajasta. Rajat ja hylkäyskäyttäytyminen kuuluvat todellisille komponenteille ja asetuksille. Säilytä HTTP-vastaus ja asiaankuuluvat lokit havainnon kanssa.

Kun HTTPS on päästä päähän tavallisessa CONNECT-tunnelissa, välityspalvelin ei voi lukea ja valikoiden poistaa sisempää API-kenttää. Otsikoiden tarkastelu kuuluu silloin TLS-päätepisteille tai nimenomaisesti luotetulle tarkastusvälittäjälle.