FastAPI 및 Discord 통합으로 문의 양식 백엔드 구축

이 튜토리얼에서는 FastAPI를 사용하여 연락처 양식 제출을 관리하고 웹후크를 통해 Discord 채널로 전달하는 강력하고 안전한 백엔드 API를 구축하는 방법을 보여줍니다. 또한 액세스 제어를 위한 중요한 CORS 구성에 대해서도 다룰 것입니다.

전제 조건:

• 파이썬 3.11
• 빠른API
• httpx(비동기 HTTP 요청용)
• Discord 웹훅 URL

1단계: 프로젝트 설정

프로젝트 디렉토리 생성 및 필요한 패키지 설치:

pip install fastapi uvicorn httpx python-dotenv

2단계: FastAPI 애플리케이션 생성

만들기 main.py:

import os
from fastapi import FastAPI, HTTPException
from fastapi.middleware.cors import CORSMiddleware
from pydantic import BaseModel
import httpx

app = FastAPI()

# CORS Configuration (Security!)
app.add_middleware(
    CORSMiddleware,
    allow_origins=["https://vicentereyes.org", "https://www.vicentereyes.org"],
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)

3단계: 데이터 모델 정의

데이터 구조에 Pydantic 사용:

class FormData(BaseModel):
    name: str
    email: str
    message: str
    service: str
    companyName: str
    companyUrl: str

4단계: 제출 엔드포인트

양식 제출 핸들러 추가:

@app.post("/submit/")
@app.post("/submit")  # Handles both /submit and /submit/
async def submit_form(form_data: FormData):
    try:
        # Format message for Discord
        message_content = {
            "content": f"New form submission:\n"
                       f"**Name:** {form_data.name}\n"
                       f"**Email:** {form_data.email}\n"
                       f"**Message:** {form_data.message}\n"
                       f"**Service:** {form_data.service}\n"
                       f"**Company Name:** {form_data.companyName}\n"
                       f"**Company URL:** {form_data.companyUrl}"
        }

        # Send to Discord webhook using httpx
        async with httpx.AsyncClient() as client:
            response = await client.post(os.environ["FASTAPI_DISCORD_WEBHOOK_URL"], json=message_content)

        if response.status_code != 204:
            raise HTTPException(status_code=response.status_code, detail="Discord message failed")

        return {"message": "Form data sent successfully"}

    except Exception as e:
        raise HTTPException(status_code=500, detail=str(e))

5단계: 환경 변수

.env 파일 만들기:

<code>FASTAPI_DISCORD_WEBHOOK_URL=your_discord_webhook_url_here</code>

작동 방식:

1. 보안 CORS: 승인된 도메인으로만 API에 대한 액세스를 제한합니다.
2. 데이터 검증: Pydantic은 데이터 무결성을 보장합니다.
3. 비동기 Discord 통합: 효율적으로 Discord에 메시지를 보냅니다.
4. 강력한 오류 처리: 유익한 오류 응답을 제공합니다.

애플리케이션 실행:

uvicorn main:app --reload

http://localhost:8000에서 API에 액세스하세요.

보안 모범 사례:

• CORS 제한: 필요한 도메인만 허용하세요.
• 환경 변수: 민감한 정보를 안전하게 저장하세요.
• 입력 유효성 검사: 항상 사용자 입력의 유효성을 검사합니다.
• 종합적인 오류 처리: 민감한 세부정보 노출을 피하세요.

프런트엔드 통합 예:

fetch('your_api_url/submit', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ /* form data */ })
});

결론:

이 보안 FastAPI 백엔드는 문의 양식을 처리하고 Discord와 통합하기 위한 안정적이고 효율적인 방법을 제공합니다. 비동기 작업과 강력한 오류 처리를 사용하면 고성능의 안전한 솔루션이 보장됩니다.

코드: https://www.php.cn/link/d92d7ec47187a662aacda2d4b4c7628e 라이브: https://www.php.cn/link/775bc655c77d679c193f1982dac04668

위 내용은 FastAPI 및 Discord 통합으로 문의 양식 백엔드 구축의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!