Design
Entwickler-Dokumentation

API-Referenz

Erstellen Sie leistungsstarke Integrationen mit der Icebox API. Greifen Sie programmatisch auf E-Mails, Kontakte und mehr zu.

RESTful-Design

Saubere, vorhersehbare URLs und Standard-HTTP-Methoden

Standardmassig Sicher

OAuth 2.0 und API-Schlussel-Authentifizierungsoptionen

Echtzeit-Webhooks

Erhalten Sie sofortige Benachrichtigungen bei Ereignissen

Offizielle SDKs

Bibliotheken fur beliebte Sprachen und Frameworks

Basis-URL
https://api.icebox.cool/v1

Schnellstart

Starten Sie mit der Icebox API in wenigen Minuten.

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-Anfrage
curl -X GET "https://api.icebox.cool/v1/emails" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Antwort
{
  "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-Endpunkte

Erkunden Sie die verfugbaren Endpunkte nach Ressource organisiert.

E-Mails

Senden, empfangen und verwalten Sie E-Mail-Nachrichten

GET/emailsAlle E-Mails auflisten
GET/emails/{id}Eine bestimmte E-Mail abrufen
POST/emailsEine neue E-Mail senden
PUT/emails/{id}E-Mail-Metadaten aktualisieren
DELETE/emails/{id}Eine E-Mail loschen

Kontakte

Verwalten Sie Ihr Adressbuch und Kontaktinformationen

GET/contactsAlle Kontakte auflisten
GET/contacts/{id}Einen bestimmten Kontakt abrufen
POST/contactsEinen neuen Kontakt erstellen
PUT/contacts/{id}Einen Kontakt aktualisieren
DELETE/contacts/{id}Einen Kontakt loschen

Ordner & Labels

Organisieren Sie E-Mails mit Ordnern und Labels

GET/foldersAlle Ordner auflisten
POST/foldersEinen neuen Ordner erstellen
GET/labelsAlle Labels auflisten
POST/labelsEin neues Label erstellen

Webhooks

Erhalten Sie Echtzeit-Benachrichtigungen fur Ereignisse

GET/webhooksWebhook-Abonnements auflisten
POST/webhooksEinen Webhook erstellen
DELETE/webhooks/{id}Einen Webhook loschen

Konto

Verwalten Sie Kontoeinstellungen und Praferenzen

GET/accountKontodetails abrufen
PUT/accountKontoeinstellungen aktualisieren
GET/account/usageAPI-Nutzungsstatistiken abrufen

Anhange

Hoch- und herunterladen von E-Mail-Anhangen

GET/attachments/{id}Anhang herunterladen
POST/attachmentsAnhang hochladen
DELETE/attachments/{id}Anhang loschen

Offizielle SDKs

Nutzen Sie unsere offiziellen Bibliotheken fur schnellere Integration.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Ratenlimits

API-Ratenlimits basieren auf Ihrer Abonnementstufe.

StufeRatenlimitTageslimit
Kostenlos100 Anfragen/Min1.000/Tag
Pro1.000 Anfragen/Min50.000/Tag
Business5.000 Anfragen/Min250.000/Tag
EnterpriseIndividuellUnbegrenzt

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung uber API-Schlussel oder OAuth 2.0-Token. Fugen Sie Ihre Anmeldedaten im Authorization-Header ein.

Authorization: Bearer YOUR_API_KEY

Bereit loszulegen?

Erstellen Sie einen API-Schlussel und beginnen Sie heute mit Ihrer Integration.