Thema
Ontwikkelaarsdocumentatie

API Referentie

Bouw krachtige integraties met de Icebox API. Krijg programmatisch toegang tot e-mails, contacten en meer.

RESTful Ontwerp

Schone, voorspelbare URLs en standaard HTTP-methoden

Standaard Veilig

OAuth 2.0 en API-sleutel authenticatie opties

Real-time Webhooks

Ontvang direct meldingen wanneer gebeurtenissen plaatsvinden

Officiele SDKs

Bibliotheken voor populaire talen en frameworks

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

Snelstart

Ga binnen enkele minuten aan de slag met de 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 Verzoek
curl -X GET "https://api.icebox.cool/v1/emails" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Antwoord
{
  "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 Endpoints

Verken de beschikbare endpoints georganiseerd per resource.

E-mails

Verzend, ontvang en beheer e-mailberichten

GET/emailsAlle e-mails weergeven
GET/emails/{id}Een specifieke e-mail ophalen
POST/emailsEen nieuwe e-mail verzenden
PUT/emails/{id}E-mail metadata bijwerken
DELETE/emails/{id}Een e-mail verwijderen

Contacten

Beheer uw adresboek en contactgegevens

GET/contactsAlle contacten weergeven
GET/contacts/{id}Een specifiek contact ophalen
POST/contactsEen nieuw contact aanmaken
PUT/contacts/{id}Een contact bijwerken
DELETE/contacts/{id}Een contact verwijderen

Mappen en Labels

Organiseer e-mails met mappen en labels

GET/foldersAlle mappen weergeven
POST/foldersEen nieuwe map aanmaken
GET/labelsAlle labels weergeven
POST/labelsEen nieuw label aanmaken

Webhooks

Ontvang real-time meldingen voor gebeurtenissen

GET/webhooksWebhook-abonnementen weergeven
POST/webhooksEen webhook aanmaken
DELETE/webhooks/{id}Een webhook verwijderen

Account

Beheer accountinstellingen en voorkeuren

GET/accountAccountgegevens ophalen
PUT/accountAccountinstellingen bijwerken
GET/account/usageAPI-gebruiksstatistieken ophalen

Bijlagen

Upload en download e-mailbijlagen

GET/attachments/{id}Bijlage downloaden
POST/attachmentsBijlage uploaden
DELETE/attachments/{id}Bijlage verwijderen

Officiele SDKs

Gebruik onze officiele bibliotheken om sneller te integreren.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Rate Limits

API rate limits zijn gebaseerd op uw abonnementsniveau.

NiveauRate LimitDagelijks Limiet
Gratis100 verzoeken/min1.000/dag
Pro1.000 verzoeken/min50.000/dag
Business5.000 verzoeken/min250.000/dag
EnterpriseAangepastOnbeperkt

Authenticatie

Alle API-verzoeken vereisen authenticatie via API-sleutel of OAuth 2.0-token. Voeg uw referenties toe in de Authorization-header.

Authorization: Bearer YOUR_API_KEY

Klaar om te beginnen?

Maak een API-sleutel aan en begin vandaag nog met het bouwen van uw integratie.