Menu
Use when integrating third-party APIs (e.g. SMTP emails, SMS notification gateways, payment checkout gates, or OCR parsers).
Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.
Baseado na classificação ocupacional SOC
| 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.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.