Thème
Documentation Developpeur

Référence API

Créez des intégrations puissantes avec l'API Icebox. Accédez aux emails, contacts et plus de manière programmatique.

Conception RESTful

URLs propres et prévisibles avec méthodes HTTP standard

Sécurisé par Défaut

Options d'authentification OAuth 2.0 et clé API

Webhooks en Temps Réel

Recevez des notifications instantanées lors d'événements

SDKs Officiels

Bibliotheques pour langages et frameworks populaires

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

Démarrage 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);
Requête cURL
curl -X GET "https://api.icebox.cool/v1/emails" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
Réponse
{
  "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 organisés par ressource.

Emails

Envoyez, recevez et gérez les messages email

GET/emailsLister tous les emails
GET/emails/{id}Obtenir un email specifique
POST/emailsEnvoyer un nouvel email
PUT/emails/{id}Mettre à jour les métadonnées
DELETE/emails/{id}Supprimer un email

Contacts

Gérez votre carnet d'adresses et informations de contact

GET/contactsLister tous les contacts
GET/contacts/{id}Obtenir un contact specifique
POST/contactsCréer un nouveau contact
PUT/contacts/{id}Mettre à 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/foldersCréer un nouveau dossier
GET/labelsLister tous les labels
POST/labelsCréer un nouveau label

Webhooks

Recevez des notifications en temps réel pour les événements

GET/webhooksLister les abonnements webhook
POST/webhooksCréer un webhook
DELETE/webhooks/{id}Supprimer un webhook

Compte

Gérez les paramètres et préférences du compte

GET/accountObtenir les détails du compte
PUT/accountMettre à jour les paramètres
GET/account/usageObtenir les stats d'utilisation API

Pièces Jointes

Téléchargez et envoyez des pièces jointes

GET/attachments/{id}Télécharger une pièce jointe
POST/attachmentsEnvoyer une pièce jointe
DELETE/attachments/{id}Supprimer une pièce 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 basées sur votre niveau d'abonnement.

NiveauLimite de TauxLimite Journaliere
Gratuit100 requêtes/min1 000/jour
Pro1 000 requêtes/min50 000/jour
Business5 000 requêtes/min250 000/jour
EntreprisePersonnaliséIllimite

Authentification

Toutes les requêtes API nécessitent une authentification via clé API ou token OAuth 2.0. Incluez vos identifiants dans l'en-tête Authorization.

Authorization: Bearer YOUR_API_KEY

Prêt à commencer ?

Créez une clé API et commencez à construire votre intégration aujourd'hui.