المظهر
وثائق المطورين

مرجع API

قم ببناء تكاملات قوية مع Icebox API. الوصول إلى رسائل البريد الإلكتروني وجهات الاتصال والمزيد برمجياً.

الحصول على مفتاح 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إنشاء تسمية جديدة

خطافات الويب

تلقي إشعارات فورية للأحداث

GET/webhooksعرض اشتراكات Webhook
POST/webhooksإنشاء Webhook
DELETE/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/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

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

مستعد للبدء؟

أنشئ مفتاح API وابدأ في بناء تكاملك اليوم.

الحصول على مفتاح APIاقرأ الوثائق الكاملة →
العودة للرئيسية →