13장. REST API 와 FastAPI

정리

• API 는 프로그램끼리 주고받는 약속이고, REST 는 자원을 주소로, 할 일을 메서드로 나타내는 설계 방식입니다.
• HTTP 요청은 메서드, 주소, 머리글, 본문으로, 응답은 상태 코드와 본문으로 되어 있습니다. 4xx 는 부른 쪽, 5xx 는 서버의 오류입니다.
• 모델은 미리 학습해 판과 함께 파일로 저장하고, 서버가 뜰 때 한 번 불러 요청마다 예측만 합니다. 전처리까지 파이프라인으로 묶어 저장합니다.
• FastAPI 는 타입 힌트와 Pydantic 모델로 입력을 검사하고(422), /docs 문서를 만들어 줍니다. TestClient 로 서버 없이 시험하고 uvicorn 으로 띄웁니다.
• 인증은 누구인지(401), 권한은 무엇을 해도 되는지(403)입니다. API 키는 해시로, 비밀번호는 소금을 붙인 여러 번의 해시로 보관하고, 비밀은 환경 변수에서 읽습니다.
• JWT 토큰에는 사용자, 역할, 만료 시각을 담아 서명하고, 역할 확인은 Depends 로 엔드포인트마다 붙입니다. 요청은 비밀을 빼고 기록합니다.