RESTful 설계
깔끔하고 예측 가능한 URL과 표준 HTTP 메서드
기본 보안
OAuth 2.0 및 API 키 인증 옵션
실시간 웹훅
이벤트 발생 시 즉시 알림 받기
공식 SDK
인기 있는 언어 및 프레임워크용 라이브러리
기본 URL
https://api.icebox.cool/v1빠른 시작
몇 분 만에 Icebox API를 시작하세요.
JavaScript
// Install the SDK
npm install @icebox/sdk
// Initialize the client
import { Icebox } from '@icebox/sdk';
const icebox = new Icebox({
apiKey: 'your_api_key_here'
});
// Fetch emails from inbox
const emails = await icebox.emails.list({
folder: 'inbox',
limit: 10
});
console.log(emails);cURL 요청
curl -X GET "https://api.icebox.cool/v1/emails" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"응답
{
"data": [
{
"id": "msg_abc123",
"subject": "Welcome to Icebox",
"from": {
"email": "hello@icebox.cool",
"name": "Icebox Team"
},
"date": "2025-01-15T10:30:00Z",
"snippet": "Thanks for signing up...",
"labels": ["inbox", "unread"]
}
],
"pagination": {
"total": 156,
"page": 1,
"per_page": 10
}
}API 엔드포인트
리소스별로 정리된 사용 가능한 엔드포인트를 탐색하세요.
이메일
이메일 메시지 보내기, 받기 및 관리
GET
/emails모든 이메일 나열GET
/emails/{id}특정 이메일 가져오기POST
/emails새 이메일 보내기PUT
/emails/{id}이메일 메타데이터 업데이트DELETE
/emails/{id}이메일 삭제연락처
주소록 및 연락처 정보 관리
GET
/contacts모든 연락처 나열GET
/contacts/{id}특정 연락처 가져오기POST
/contacts새 연락처 만들기PUT
/contacts/{id}연락처 업데이트DELETE
/contacts/{id}연락처 삭제폴더 및 라벨
폴더와 라벨로 이메일 정리
GET
/folders모든 폴더 나열POST
/folders새 폴더 만들기GET
/labels모든 라벨 나열POST
/labels새 라벨 만들기웹훅
이벤트에 대한 실시간 알림 받기
GET
/webhooks웹훅 구독 나열POST
/webhooks웹훅 만들기DELETE
/webhooks/{id}웹훅 삭제계정
계정 설정 및 환경 설정 관리
GET
/account계정 세부 정보 가져오기PUT
/account계정 설정 업데이트GET
/account/usageAPI 사용 통계 가져오기첨부 파일
이메일 첨부 파일 업로드 및 다운로드
GET
/attachments/{id}첨부 파일 다운로드POST
/attachments첨부 파일 업로드DELETE
/attachments/{id}첨부 파일 삭제공식 SDK
공식 라이브러리를 사용하여 더 빠르게 통합하세요.
JavaScript / TypeScript
npm install @icebox/sdkPython
pip install icebox-sdkRuby
gem install iceboxGo
go get github.com/icebox/sdk-go요청 제한
API 요청 제한은 구독 등급에 따라 다릅니다.
등급요청 제한일일 제한
무료100 요청/분1,000/일
프로1,000 요청/분50,000/일
비즈니스5,000 요청/분250,000/일
엔터프라이즈맞춤형무제한
인증
모든 API 요청에는 API 키 또는 OAuth 2.0 토큰을 통한 인증이 필요합니다. Authorization 헤더에 자격 증명을 포함하세요.
Authorization: Bearer YOUR_API_KEY