`microdot.cors` — dijeljenje resursa između izvora (Cross-Origin Resource Sharing)#

Dodaje zaglavlja koja preglednik treba kako bi dopustio da JavaScript koji se izvodi na jednom izvoru poziva vaše krajnje točke smještene na kameri na drugom izvoru. Klasa se sama povezuje s aplikacijskim OPTIONS rukovateljem (za preflight zahtjeve) i s hookom nakon zahtjeva (za zaglavlja Access-Control-* na uobičajenim odgovorima).

class CORS#

class microdot.cors.CORS(app: Microdot | None = None, allowed_origins=None, allow_credentials: bool = False, allowed_methods: list | None = None, expose_headers: list | None = None, allowed_headers: list | None = None, max_age: int | None = None, handle_cors: bool = True)#

app: Instanca microdot.Microdot na koju se treba prikvačiti. Može biti None za odgodu prikvačivanja; kasnije pozovite initialize().
allowed_origins: Lista nizova izvora (["https://app.example.com"]) ili doslovni '*' za dopuštanje bilo kojeg izvora. Izvori koji se ne podudaraju s ovom listom ne dobivaju CORS zaglavlja, što preglednik tumači kao „ovaj zahtjev nije dopušten”.
allow_credentials: Ako je True, dodaje Access-Control-Allow-Credentials: true kako bi preglednik slao kolačiće i auth zaglavlja s zahtjevima između izvora. Ne može se koristiti s allowed_origins='*' za bilo koji zahtjev koji treba vjerodajnice (preglednici odbijaju tu kombinaciju).
allowed_methods: Lista metoda (['GET', 'POST']) koje preglednik smije koristiti između izvora. None znači bilo koja.
expose_headers: Lista naziva zaglavlja odgovora koje preglednik smije izložiti JavaScriptu.
allowed_headers: Lista naziva zaglavlja zahtjeva koje klijenti smiju uključiti između izvora. None znači bilo koje (ponavlja Access-Control-Request-Headers iz preflighta).
max_age: Sekunde tijekom kojih preglednik smije keširati rezultat preflighta. Izostavljanje znači da preglednik ponovno provjerava svaki preflight.
handle_cors: Ako je False, klasa je konfigurirana, ali se zapravo ne prikvačuje – korisno kada želite ručno kombinirati izlaz njezine get_cors_headers() s drugim međusoftverom.

initialize(app: Microdot, handle_cors: bool = True)#: Prikvačuje se na app ako je konstrukcija bila odgođena.

get_cors_headers(request) → dict#: Izračunava skup zaglavlja Access-Control-* koja se primjenjuju na request. Interno se koristi u hooku nakon zahtjeva; aplikacije ga mogu pozvati izravno kada emitiraju CORS zaglavlja iz prilagođenog međusoftvera.

allowed_origins: list | str | None#: Konfigurirana lista izvora, ili doslovni '*'. Zrcali argument konstruktora allowed_origins; preradite ga tijekom izvođenja da biste promijenili politiku bez ponovne izgradnje objekta.

allow_credentials: bool#: Hoće li se Access-Control-Allow-Credentials: true emitirati na podudarajućim zahtjevima. Zrcali argument konstruktora allow_credentials.

allowed_methods: list | None#: Lista naziva metoda dopuštenih između izvora, ili None za „bilo koja”. Zrcali argument konstruktora allowed_methods.

expose_headers: list | None#: Lista zaglavlja odgovora koje preglednik smije izložiti JavaScriptu, ili None za izostavljanje zaglavlja Access-Control-Expose-Headers. Zrcali argument konstruktora expose_headers.

allowed_headers: list | None#: Lista naziva zaglavlja zahtjeva prihvaćenih između izvora, pretvorenih u mala slova, ili None za „ponovi što god je preflight tražio”. Zrcali argument konstruktora allowed_headers (konstruktor pretvara listu u mala slova prije spremanja).

max_age: int | None#: Sekunde tijekom kojih preglednik smije keširati odgovor na preflight, ili None za izostavljanje zaglavlja Access-Control-Max-Age. Zrcali argument konstruktora max_age.

Primjer:

from microdot import Microdot
from microdot.cors import CORS

app = Microdot()
CORS(app,
     allowed_origins=['https://dashboard.example.com'],
     allow_credentials=True,
     max_age=86400)

@app.get('/api/status')
async def status(request):
    return {'ok': True}

Preflight OPTIONS zahtjev obrađuje se automatski; kamera vraća odgovarajuća zaglavlja Access-Control-* i 204 No Content. Stvarni GET / POST / itd. odgovori preuzimaju zaglavlje Access-Control-Allow-Origin putem registriranog hooka nakon zahtjeva.

microdot.cors — dijeljenje resursa između izvora (Cross-Origin Resource Sharing)#

class CORS#

`microdot.cors` — dijeljenje resursa između izvora (Cross-Origin Resource Sharing)#