תיעוד למפתחים
הפניית API
בנו אינטגרציות חזקות עם Icebox API. גישה לאימיילים, אנשי קשר ועוד באופן תכנותי.
עיצוב RESTful
כתובות URL נקיות וצפויות ושיטות HTTP סטנדרטיות
מאובטח כברירת מחדל
אפשרויות אימות OAuth 2.0 ומפתח API
Webhooks בזמן אמת
קבל התראות מיידיות כאשר מתרחשים אירועים
SDKs רשמיים
ספריות לשפות ומסגרות פופולריות
כתובת 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צור תווית חדשהWebhooks
קבל התראות בזמן אמת על אירועים
GET
/webhooksרשימת מנויי webhookPOST
/webhooksצור webhookDELETE
/webhooks/{id}מחק webhookחשבון
נהל הגדרות והעדפות חשבון
GET
/accountקבל פרטי חשבוןPUT
/accountעדכן הגדרות חשבוןGET
/account/usageקבל סטטיסטיקות שימוש APIקבצים מצורפים
העלה והורד קבצים מצורפים לאימייל
GET
/attachments/{id}הורד קובץ מצורףPOST
/attachmentsהעלה קובץ מצורףDELETE
/attachments/{id}מחק קובץ מצורףSDKs רשמיים
השתמש בספריות הרשמיות שלנו לאינטגרציה מהירה יותר.
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