Tema
Geliştirici Dokümantasyonu

API Referansı

Icebox API ile güçlü entegrasyonlar oluşturun. E-postalara, kişilere ve daha fazlasına programatik olarak erişin.

RESTful Tasarim

Temiz, öngörülebilir URL'ler ve standart HTTP yöntemleri

Varsayılan Olarak Güvenli

OAuth 2.0 ve API anahtarı doğrulama seçenekleri

Gerçek Zamanlı Webhook'lar

Olaylar gerçekleştiğinde anında bildirim alın

Resmi SDK'lar

Popüler diller ve frameworkler için kütüphaneler

Temel URL
https://api.icebox.cool/v1

Hızlı Başlangıç

Icebox API'yi dakikalar içinde kullanmaya başlayın.

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 İsteği
curl -X GET "https://api.icebox.cool/v1/emails" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Yanıt
{
  "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 Uç Noktalari

Kaynağa göre organize edilmiş mevcut uç noktaları keşfedin.

E-postalar

E-posta mesajları gönderin, alın ve yönetin

GET/emailsTüm e-postaları listele
GET/emails/{id}Belirli bir e-postayı al
POST/emailsYeni e-posta gönder
PUT/emails/{id}E-posta meta verilerini güncelle
DELETE/emails/{id}E-postayı sil

Kişiler

Adres defterinizi ve kişi bilgilerinizi yönetin

GET/contactsTüm kişileri listele
GET/contacts/{id}Belirli bir kişiyi al
POST/contactsYeni kişi oluştur
PUT/contacts/{id}Kişiyi güncelle
DELETE/contacts/{id}Kişiyi sil

Klasörler ve Etiketler

E-postaları klasörler ve etiketlerle düzenleyin

GET/foldersTüm klasörleri listele
POST/foldersYeni klasör oluştur
GET/labelsTüm etiketleri listele
POST/labelsYeni etiket oluştur

Webhook

Olaylar için gerçek zamanlı bildirimler alın

GET/webhooksWebhook aboneliklerini listele
POST/webhooksWebhook oluştur
DELETE/webhooks/{id}Webhook'u sil

Hesap

Hesap ayarlarını ve tercihlerini yönetin

GET/accountHesap ayrintlarini al
PUT/accountHesap ayarlarını güncelle
GET/account/usageAPI kullanım istatistiklerini al

Ekler

E-posta eklerini yükleyin ve indirin

GET/attachments/{id}Eki indir
POST/attachmentsEk yükle
DELETE/attachments/{id}Eki sil

Resmi SDK'lar

Daha hızlı entegrasyon için resmi kütüphanelerimizi kullanın.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Hız Limitleri

API hız limitleri abonelik seviyenize göre belirlenir.

SeviyeHız LimitiGünlük Limit
Ücretsiz100 istek/dk1.000/gün
Pro1.000 istek/dk50.000/gün
İşletme5.000 istek/dk250.000/gün
KurumsalÖzelSınırsız

Kimlik Doğrulama

Tüm API istekleri, API anahtarı veya OAuth 2.0 token ile kimlik doğrulama gerektirir. Kimlik bilgilerinizi Authorization başlığına ekleyin.

Authorization: Bearer YOUR_API_KEY

Başlamaya hazır mısınız?

Bir API anahtarı oluşturun ve bugün entegrasyonunuzu oluşturmaya başlayın.