Kuidas edastav puhverserver kohtleb kohandatud API-päist
Jälgige API versiooni välja tavalise edastamise, konkreetse hüppe Connection-reeglite ja selgesõnaliselt seadistatud päisekorra kaudu.
API võib kanda oma versiooni kohandatud päringuväljas, näiteks API-Version. Tavaline edastav puhverserver ei peaks seda välja kõrvale jätma üksnes seetõttu, et nimi on tundmatu. HTTP nõuab tundmatute väljade edastamist, kui ei kehti määratletud erand või seadistatud kord.
Väli Connection on üks selline erand. Võrrelge neid näidislikke päringuid:
API-Version: 2026-10
Connection: keep-alive
Siin ei ole API väli märgitud selle ühenduse jaoks kohalikuks. Järgmises näites muudab saatja selle ulatust selgesõnaliselt:
API-Version: 2026-10
Connection: API-Version
Edastav puhverserver eemaldab Connectionis nimetatud väljad enne edastamist ning eemaldab või asendab ühenduspõhised juhised ise. Seetõttu ei tohiks päritolule mõeldud rakenduse päis sellesse märgistusloendisse sattuda.
Leidke koht, kus väli muutub
Võrrelge kliendi koostatud päringut, puhverserveri vastuvõetud ja edastatud välju ning seda, mida päritolu vastu võttis. Klient võib päise enne puhverserveri nägemist ära jätta; seadistatud filter võib selle meelega eemaldada; server võib päringu tagasi lükata päise piirmäära ületamise tõttu.
Ärge järeldage vaikset eemaldamist üksnes vanas juurutusviisis teatatud päise suuruse lävendist. Piirmäärad ja tagasilükkamise käitumine kuuluvad tegelike komponentide ja seadistuse juurde. Hoidke HTTP vastust ja asjakohaseid logisid vaatluse juures.
Otsast-otsani HTTPS-i puhul tavalises CONNECT-tunnelis ei saa puhverserver sisemist API välja lugeda ega valikuliselt eemaldada. Päiste kontroll kuulub siis TLS-otspunktidele või selgesõnaliselt usaldatud kontrollivahendajale.