Thème
Documentation Developpeur

Reference API

Creez des integrations puissantes avec l'API Icebox. Accedez aux emails, contacts et plus de maniere programmatique.

Conception RESTful

URLs propres et previsibles avec methodes HTTP standard

Securise par Defaut

Options d'authentification OAuth 2.0 et cle API

Webhooks en Temps Reel

Recevez des notifications instantanees lors d'evenements

SDKs Officiels

Bibliotheques pour langages et frameworks populaires

URL de Base
https://api.icebox.cool/v1

Demarrage Rapide

Commencez a utiliser l'API Icebox en quelques minutes.

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);
Requete cURL
curl -X GET "https://api.icebox.cool/v1/emails" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Reponse
{
  "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
  }
}

Points de Terminaison API

Explorez les endpoints disponibles organises par ressource.

Emails

Envoyez, recevez et gerez les messages email

GET/emailsLister tous les emails
GET/emails/{id}Obtenir un email specifique
POST/emailsEnvoyer un nouvel email
PUT/emails/{id}Mettre a jour les metadonnees
DELETE/emails/{id}Supprimer un email

Contacts

Gerez votre carnet d'adresses et informations de contact

GET/contactsLister tous les contacts
GET/contacts/{id}Obtenir un contact specifique
POST/contactsCreer un nouveau contact
PUT/contacts/{id}Mettre a jour un contact
DELETE/contacts/{id}Supprimer un contact

Dossiers et Labels

Organisez les emails avec dossiers et labels

GET/foldersLister tous les dossiers
POST/foldersCreer un nouveau dossier
GET/labelsLister tous les labels
POST/labelsCreer un nouveau label

Webhooks

Recevez des notifications en temps reel pour les evenements

GET/webhooksLister les abonnements webhook
POST/webhooksCreer un webhook
DELETE/webhooks/{id}Supprimer un webhook

Compte

Gerez les parametres et preferences du compte

GET/accountObtenir les details du compte
PUT/accountMettre a jour les parametres
GET/account/usageObtenir les stats d'utilisation API

Pieces Jointes

Telechargez et envoyez des pieces jointes

GET/attachments/{id}Telecharger une piece jointe
POST/attachmentsEnvoyer une piece jointe
DELETE/attachments/{id}Supprimer une piece jointe

SDKs Officiels

Utilisez nos bibliotheques officielles pour integrer plus rapidement.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Limites de Taux

Les limites de taux API sont basees sur votre niveau d'abonnement.

NiveauLimite de TauxLimite Journaliere
Gratuit100 requetes/min1 000/jour
Pro1 000 requetes/min50 000/jour
Business5 000 requetes/min250 000/jour
EntreprisePersonnaliseIllimite

Authentification

Toutes les requetes API necessitent une authentification via cle API ou token OAuth 2.0. Incluez vos identifiants dans l'en-tete Authorization.

Authorization: Bearer YOUR_API_KEY

Pret a commencer?

Creez une cle API et commencez a construire votre integration aujourd'hui.