القائمة
Use when integrating third-party APIs (e.g. SMTP emails, SMS notification gateways, payment checkout gates, or OCR parsers).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Use when adding a brand-new CRUD resource beyond the core entity (e.g. a second model the PS requires).
Use when building or restyling any page or component.
Use when constructing forms, inputs, submit behaviors, validation displays, and feedback toast alerts.
Use when creating new Next.js route handlers using the custom helper wrapper.
Use whenever the Prisma schema changes and a migration is needed.
Use when adapting the template's placeholder Item entity to a hackathon problem statement's actual domain entity.
| name | integrate-external-api |
| description | Use when integrating third-party APIs (e.g. SMTP emails, SMS notification gateways, payment checkout gates, or OCR parsers). |
Follow these best practices to connect external software services securely and reliably:
Environment Config:
.env and .env.example.process.env.API_KEY_NAME.Abstract Service Layer (Mockable):
src/lib/services/ (e.g. mail.ts, sms.ts).export async function sendEmail(to: string, subject: string, body: string) {
if (process.env.NODE_ENV === "development") {
console.log(`[MOCK EMAIL SENT TO ${to}]: ${subject} - ${body}`);
return { success: true, messageID: "mock-12345" };
}
// Real API client integration (e.g. nodemailer or Sendgrid)
// ...
}
Client-side Fetch Handlers:
src/app/api/...), and fetch them using standard fetch functions from client components.