쿠키 매개변수¶
🌐 AI와 사람이 함께한 번역
이 번역은 사람의 안내를 받아 AI가 만들었습니다. 🤝
원문의 의미를 오해하거나 부자연스러워 보이는 등 오류가 있을 수 있습니다. 🤖
쿠키 매개변수를Query와Path 매개변수들과 같은 방식으로 정의할 수 있습니다.
Cookie 임포트¶
먼저Cookie를 임포트합니다:
fromtypingimportAnnotatedfromfastapiimportCookie,FastAPIapp=FastAPI()@app.get("/items/")asyncdefread_items(ads_id:Annotated[str|None,Cookie()]=None):return{"ads_id":ads_id}🤓 Other versions and variants
Tip
Prefer to use theAnnotated version if possible.
fromfastapiimportCookie,FastAPIapp=FastAPI()@app.get("/items/")asyncdefread_items(ads_id:str|None=Cookie(default=None)):return{"ads_id":ads_id}Cookie 매개변수 선언¶
그런 다음,Path와Query처럼 동일한 구조를 사용하는 쿠키 매개변수를 선언합니다.
첫 번째 값은 기본값이며, 추가 검증이나 어노테이션 매개변수 모두 전달할 수 있습니다:
fromtypingimportAnnotatedfromfastapiimportCookie,FastAPIapp=FastAPI()@app.get("/items/")asyncdefread_items(ads_id:Annotated[str|None,Cookie()]=None):return{"ads_id":ads_id}🤓 Other versions and variants
Tip
Prefer to use theAnnotated version if possible.
fromfastapiimportCookie,FastAPIapp=FastAPI()@app.get("/items/")asyncdefread_items(ads_id:str|None=Cookie(default=None)):return{"ads_id":ads_id}기술 세부사항
Cookie는Path 및Query의 "자매"클래스입니다. 이 역시 동일한 공통Param 클래스를 상속합니다.
하지만fastapi에서Query,Path,Cookie 그리고 다른 것들을 임포트할 때, 실제로는 특별한 클래스를 반환하는 함수임을 기억하세요.
Info
쿠키를 선언하기 위해서는Cookie를 사용해야 합니다. 그렇지 않으면 해당 매개변수를 쿼리 매개변수로 해석하기 때문입니다.
Info
브라우저는 쿠키를 내부적으로 특별한 방식으로 처리하기 때문에,JavaScript가 쉽게 쿠키를 다루도록 허용하지 않는다는 점을 염두에 두세요.
/docs의API docs UI로 이동하면경로 처리에 대한 쿠키문서를 확인할 수 있습니다.
하지만데이터를 채우고 "Execute"를 클릭하더라도, docs UI는JavaScript로 동작하기 때문에 쿠키가 전송되지 않고, 아무 값도 입력하지 않은 것처럼오류 메시지를 보게 될 것입니다.
요약¶
Query와Path에서 사용하는 것과 동일한 공통 패턴으로,Cookie를 사용해 쿠키를 선언합니다.