메뉴
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.