프로그래밍 방식으로 EML 파일을 생성하는 것은 이메일을 보관하거나, 레거시 시스템과 통합하거나, 알림을 자동화해야 할 때 필수적입니다.
Aspose.3D Cloud SDK for Node.js는 복잡한 작업을 처리해 주는 간단한 라이브러리를 제공하여 비즈니스 로직에 집중할 수 있게 해줍니다.

이 튜토리얼에서는 Node.js에서 EML을 생성하는 방법을 배우고, 완전한 작업 예제를 확인하며, 동등한 cURL 명령을 탐색하고, 신뢰할 수 있는 이메일 내보내기를 위한 모범 사례를 발견하게 됩니다.

Node.js에서 EML 만들기 - 단계별 가이드

  1. SDK를 설치하고 API 키를 구성합니다: npm을 사용하여 패키지를 추가하고 클라이언트 자격 증명을 사용하여 Configuration 객체를 생성합니다.
const { Configuration } = require('@asposecloud/email');

const config = new Configuration({
       clientId: 'YOUR_CLIENT_ID',
       clientSecret: 'YOUR_CLIENT_SECRET'
   });
  1. EmailApi 클라이언트 초기화: EmailApi 생성자에 구성을 전달합니다.
const { EmailApi } = require('@asposecloud/email');
const emailApi = new EmailApi(config);

자세한 내용은 EmailApi 참조를 확인하십시오.

  1. 보낸 사람, 받는 사람, 제목, 본문 및 첨부 파일이 포함된 EmailDto 생성: DTO는 모든 이메일 구성 요소를 보유합니다.
const { EmailDto, MailAddress } = require('@asposecloud/email');

const email = new EmailDto({
       from: new MailAddress({ address: 'sender@example.com', displayName: 'Sender Name' }),
       to: [new MailAddress({ address: 'recipient@example.com', displayName: 'Recipient Name' })],
       subject: 'Test Email generated via Aspose.Email Cloud SDK',
       body: 'Hello,\n\nThis is a test email created with Aspose.Email Cloud SDK for Node.js.\n\nBest regards,\nNode.js',
       isBodyHtml: false,
       attachments: [{
           name: 'sample.txt',
           content: Buffer.from('Sample attachment content').toString('base64')
       }]
   });
  1. EML 파일 생성: 형식 'Eml'을 사용하여 create를 호출합니다. 이 메서드는 바이너리 버퍼를 반환합니다.
const emlBuffer = await emailApi.create(email, 'Eml');
  1. 버퍼를 디스크에 쓰기: Node의 fs 모듈을 사용하여 파일을 저장합니다.
const fs = require('fs');
const path = require('path');

const outputFile = path.resolve(__dirname, 'output.eml');
   fs.writeFileSync(outputFile, emlBuffer);
   console.log(`EML file successfully created at: ${outputFile}`);

전체 코드 예제: Node.js로 EML 파일 만들기

다음 코드는 구성에서 파일 생성까지 전체 워크플로를 보여줍니다.

const fs = require('fs');
const path = require('path');
const {
    EmailApi,
    EmailDto,
    MailAddress,
    Configuration
} = require('@asposecloud/email');

// -----------------------------------------------------
// 1. Install the SDK and configure API keys
// -----------------------------------------------------
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';

const config = new Configuration({
    clientId: clientId,
    clientSecret: clientSecret,
    // baseUrl is optional; default is https://api.aspose.cloud
});

const emailApi = new EmailApi(config);

// -----------------------------------------------------
// 2. Initialize Email object and set properties
// -----------------------------------------------------
const email = new EmailDto({
    from: new MailAddress({
        address: 'sender@example.com',
        displayName: 'Sender Name'
    }),
    to: [
        new MailAddress({
            address: 'recipient@example.com',
            displayName: 'Recipient Name'
        })
    ],
    subject: 'Test Email generated via Aspose.Email Cloud SDK',
    body: 'Hello,\n\nThis is a test email created with Aspose.Email Cloud SDK for Node.js.\n\nBest regards,\nNode.js',
    isBodyHtml: false,
    // Optional: add a simple text attachment
    attachments: [
        {
            name: 'sample.txt',
            // Content must be Base64‑encoded
            content: Buffer.from('Sample attachment content').toString('base64')
        }
    ]
});

// -----------------------------------------------------
// 3. Generate EML file with Node.js
// -----------------------------------------------------
(async () => {
    try {
        // 'Eml' tells the service to return the message in .eml format
        const emlBuffer = await emailApi.create(email, 'Eml');

// Write the binary buffer to a file
        const outputFile = path.resolve(__dirname, 'output.eml');
        fs.writeFileSync(outputFile, emlBuffer);
        console.log(`EML file successfully created at: ${outputFile}`);
    } catch (error) {
        console.error('Failed to create EML:', error);
    }
})();

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL을 사용한 REST API로 EML 생성

아래는 REST API를 통해 동일한 작업을 수행하는 cURL 명령입니다.

  1. 액세스 토큰 가져오기
curl -X POST "https://api.aspose.cloud/connect/token" \
     -H "Content-Type: application/x-www-form-urlencoded" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. 이메일 JSON 페이로드 만들기 (email.json 파일로 저장)
{
  "from": { "address": "sender@example.com", "displayName": "Sender Name" },
  "to": [{ "address": "recipient@example.com", "displayName": "Recipient Name" }],
  "subject": "Test Email generated via Aspose.Email Cloud SDK",
  "body": "Hello,\n\nThis is a test email created with Aspose.Email Cloud SDK for Node.js.\n\nBest regards,\nNode.js",
  "isBodyHtml": false,
  "attachments": [
    {
      "name": "sample.txt",
      "content": "U2FtcGxlIGF0dGFjaG1lbnQgY29udGVudA=="
    }
  ]
}
  1. EML 생성 요청
curl -X POST "https://api.aspose.cloud/email/create?format=Eml" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d @email.json --output output.eml

이 명령을 사용하면 Node.js 코드를 작성하지 않고도 EML 파일을 생성할 수 있습니다. 자세한 내용은 공식 API 문서를 참조하십시오.

Aspose.3D Cloud SDK에 대한 사전 요구 사항 및 설정

SDK를 사용하려면 Node.js(v12 이상)와 Aspose Cloud 계정이 필요합니다.

npm install aspose3dcloud

패키지는 release page에서 직접 다운로드할 수도 있습니다. 설치 후, 무료 Aspose Cloud 계정을 만들고, clientId와 clientSecret을 얻은 다음 안전하게 보관하십시오.

이메일 생성 옵션 미세 조정

SDK는 조정할 수 있는 여러 속성을 제공합니다:

  • isBodyHtml - 이메일 본문에 HTML 마크업이 포함된 경우 true 로 설정합니다.
  • attachments - attachments 배열에 여러 객체를 추가합니다; 각 객체는 name과 Base64‑인코딩된 content를 포함해야 합니다.
  • customHeaders - 샘플에 표시되지 않았지만, 추가 MIME 헤더를 포함하기 위해 customHeaders 맵을 추가할 수 있습니다.

전체 구성 가능한 필드 목록은 EmailDto 클래스 참조를 참조하십시오.

EML 생성 모범 사례

  • 이메일 주소 검증을 API에 보내기 전에 수행하여 런타임 오류를 방지합니다.
  • 첨부 파일 내용을 Base64 인코딩하여 바이너리 데이터가 올바르게 전송되도록 합니다.
  • Configuration 객체 재사용을 통해 여러 API 호출에서 오버헤드를 줄입니다.
  • 오류를 우아하게 처리하려면 create 호출을 try/catch 블록으로 감싸고 응답을 로깅합니다.
  • 생성된 EML 파일을 안전하게 저장하고, 특히 민감한 정보를 포함하고 있는 경우에 주의합니다.

결론

Node.js에서 EML을 생성하는 것이 Aspose.3D Cloud SDK for Node.js를 사용하면 간단하고 반복 가능한 프로세스가 됩니다. 위에 설명된 단계, 코드 예제 및 모범 사례를 따르면 이메일을 EML 형식으로 안정적으로 내보내어 보관, 규정 준수 또는 후속 처리에 활용할 수 있습니다. API 자격 증명을 안전하게 보관하고 프로덕션 사용을 위한 적절한 라이선스를 확보하는 것을 잊지 마세요; 가격 옵션을 확인하거나 임시 라이선스 페이지에서 임시 라이선스를 요청할 수 있습니다. 즐거운 코딩 되세요!

자주 묻는 질문

Node.js에서 Aspose.3D Cloud SDK를 사용하여 EML을 어떻게 생성합니까?
EmailApi 클래스를 사용하여 EmailDto를 만든 다음, 'Eml' 형식으로 create를 호출합니다. 이 문서의 전체 예제에서는 정확한 코드를 보여줍니다.

EML 파일을 만들 때 어떤 옵션을 사용자 정의할 수 있나요?
isBodyHtml를 토글하고, 여러 첨부 파일을 추가하며, 사용자 정의 MIME 헤더를 정의할 수 있습니다. 자세한 내용은 Configuration / Options 섹션을 참조하세요.

프로덕션 사용에 라이선스가 필요합니까?
프로덕션 배포에는 유효한 라이선스가 필요합니다. 임시 라이선스 페이지에서 임시 라이선스를 얻거나 Aspose 스토어를 통해 정식 라이선스를 구매하십시오.

자세히 보기