Phần 2: API trên edge Part 2: APIs on the edge · Bài 1/2 Lesson 1/2

Pages Functions cho route `/api/` Pages Functions for `/api/` routes

Đặt handler trong `functions/` để xử lý form, webhook, proxy nhẹ. Phù hợp logic gắn với site Pages. Put handlers in `functions/` for forms, webhooks, light proxying. Good for logic tied to your Pages site.

Các bước thực hiện Step-by-step

Tạo thư mục `functions/` cạnh output static. Create a `functions/` folder beside static output.
Thêm `functions/api/hello.ts` export `onRequestGet`. Add `functions/api/hello.ts` exporting `onRequestGet`.
Deploy — gọi `https://<site>/api/hello`. Deploy — call `https://<site>/api/hello`.
Binding D1/KV trong Pages project settings nếu cần. Bind D1/KV in Pages project settings if needed.

Giải thích chi tiết Detailed explanation

Pages Functions chạy trên Workers runtime — API gắn với site, không cần server riêng. Pages Functions run on the Workers runtime — APIs colocated with your site, no separate server.

Lưu ý (best practices) Note (best practices)

Luôn `await` hoặc `ctx.waitUntil()` mọi Promise — nếu không, Worker có thể kết thúc trước khi tác vụ nền hoàn tất. Always `await` or use `ctx.waitUntil()` for every Promise — otherwise the Worker may terminate before background work completes.

Nguồn: Source: Workers Best Practices Workers Best Practices ↗

Ví dụ triển khai (Cloudflare Resources) Deployment examples (Cloudflare Resources)

Tutorial, solution guide và reference từ developers.cloudflare.com/resources ↗ — gợi ý theo chủ đề bài học. Tutorials, solution guides, and reference docs from developers.cloudflare.com/resources ↗ — matched to this lesson topic.