Hướng dẫn tích hợp API xác thực PinMe
Skill hướng dẫn gọi API proxy xác thực Identity Platform của PinMe trong Worker TypeScript: tạo user, xác minh id_token, truy vấn và liệt kê người dùng.
Web · APITrung cấp★ 3,746⑂ 277Điểm AI 8/10Cập nhật lần cuối: 12 thg 9, 2026
Giúp được gì
- Mô tả đầy đủ 4 API xác thực của PinMe (
create_user,verify_token,user,list_users) kèm endpoint, tham số, bảng mã lỗi HTTP. - Quy tắc xác thực chung: header
X-API-Keycùng queryproject_name, kèm các kiểu TypeScript (ApiEnvelope<T>,UserInfo) và hàm fetch sẵn dùng. - Hướng dẫn khởi tạo Firebase Auth ở frontend (bắt buộc gán
tenant_id), đăng nhập email/Google để lấyid_tokenrồi để Worker xác minh. - Bảng lỗi thường gặp: 403 nghĩa là email chưa xác minh (không phải token hết hạn), phải phân trang hết
next_page_token, phải kiểm tra cảresult.code === 200.
Phù hợp với ai
- Lập trình viên xây backend Worker triển khai qua PinMe cần chức năng đăng ký/đăng nhập.
- Người mới làm việc với multi-tenant Firebase Identity Platform, dễ nhầm lẫn giữa API key server và Web API key.
- Nhóm muốn chuẩn hóa cách xử lý lỗi xác thực.
Ví dụ sử dụng
- "Viết endpoint đăng ký email/mật khẩu trong Worker" → sinh code gọi
create_uservà nhắc người dùng xác minh email. - "Tạo middleware kiểm tra id_token" → gọi
verify_token, phân nhánh 403 (chưa xác minh email) và 401 (token hết hạn). - "Xuất danh sách toàn bộ người dùng cho trang admin" → sinh vòng lặp phân trang với
next_page_token.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/glitternetwork/pinme/HEAD/skills/pinme-auth/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
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 và clone repo:
git clone https://github.com/glitternetwork/pinme.git - Tạo thư mục skills nếu chưa có:
mkdir -p ~/.claude/skills - Copy skill:
cp -r pinme/skills/pinme-auth ~/.claude/skills/ - Kiểm tra tồn tại tệp
~/.claude/skills/pinme-auth/SKILL.md. - Khởi động lại Claude Code, mở thư mục dự án PinMe và yêu cầu ví dụ: "tích hợp xác thực PinMe vào Worker".
- Cấu hình sẵn biến môi trường
API_KEYvàPROJECT_NAMEcho Worker; tuyệt đối không đưaAPI_KEYra frontend.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT