Tích hợp API xác thực PinMe
Hướng dẫn gọi các API proxy Identity Platform của PinMe trong Worker TypeScript để tạo user, xác minh id_token và truy vấn danh sách người dùng.
Web · APITrung cấp★ 3,732⑂ 272Điểm AI 7/10Cập nhật lần cuối: 25 thg 7, 2026
Làm được gì
Skill này cung cấp cho Claude tài liệu chính xác để gắn xác thực người dùng vào Worker (TypeScript) trên nền tảng PinMe.
- 4 API chính: tạo user bằng email/mật khẩu, xác minh
id_token, lấy thông tin 1 user, liệt kê user có phân trang - Quy tắc xác thực chung: mọi request phải có header
X-API-Keyvà queryproject_namekhớp cùng một project - Kiểu TypeScript:
ApiEnvelope<T>,UserInfo,VerifyTokenData - Bảng lỗi chi tiết: 400/401/403/404/502 kèm chuỗi
data.errorcụ thể - Tích hợp frontend: khởi tạo Firebase Auth SDK, gán
auth.tenantId, đăng nhập email hoặc Google để lấyid_token - Phân biệt hai loại key:
api_keychỉ dùng ở server,auth_api_keymới được để lộ ra trình duyệt
Dành cho ai
- Lập trình viên đang xây dự án trên PinMe và cần thêm chức năng đăng nhập
- Người viết backend kiểu Cloudflare Worker + D1 và muốn xác minh token ở phía server
- Ai từng gặp lỗi token sai tenant vì quên set
tenant_idtrong Firebase Auth
Ví dụ sử dụng
- Tạo route đăng ký — "Thêm route
/signupcho Worker của tôi, tạo user bằng email/mật khẩu và gửi email xác minh" → Claude sinh code theo mẫucreateAuthUser. - Middleware xác thực — "Viết middleware kiểm tra id_token, phân biệt 401 (token hết hạn) và 403 (chưa xác minh email)".
- Xuất danh sách người dùng — "Viết script lặp hết tất cả user để xuất CSV" → dùng vòng lặp
next_page_tokennhư trong tài liệu.
· · · Hướng dẫn cài đặt · · ·
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/pinme-auth từ repo GitHub glitternetwork/pinme vào ~/.claude/skills/pinme-auth/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/glitternetwork/pinme.git /tmp/pinme && mkdir -p ~/.claude/skills && cp -r /tmp/pinme/skills/pinme-auth ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở Terminal.
- Tải repo chứa skill về thư mục tạm:
git clone https://github.com/glitternetwork/pinme.git /tmp/pinme - Tạo thư mục skill của Claude:
mkdir -p ~/.claude/skills - Copy riêng skill
pinme-auth:cp -r /tmp/pinme/skills/pinme-auth ~/.claude/skills/ - Khởi động lại Claude Code và kiểm tra
pinme-authxuất hiện trong danh sách/skills. - Trong project Worker, cấu hình biến môi trường
API_KEYvàPROJECT_NAME(ví dụwrangler secret put API_KEY) — tuyệt đối không hard-code khóa vào source. - Yêu cầu Claude, ví dụ: "Dùng skill pinme-auth để viết route xác minh đăng nhập".
Xem mã nguồn trên GitHub ↗Giấy phép: MIT