Tema
Documentazione per Sviluppatori

Riferimento API

Crea integrazioni potenti con l'API Icebox. Accedi a email, contatti e altro in modo programmatico.

Design RESTful

URL puliti e prevedibili con metodi HTTP standard

Sicuro di Default

Opzioni di autenticazione OAuth 2.0 e chiave API

Webhook in Tempo Reale

Ricevi notifiche istantanee quando si verificano eventi

SDK Ufficiali

Librerie per linguaggi e framework popolari

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

Avvio Rapido

Inizia a usare l'API Icebox in pochi minuti.

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

Endpoint API

Esplora gli endpoint disponibili organizzati per risorsa.

Email

Invia, ricevi e gestisci messaggi email

GET/emailsElenca tutte le email
GET/emails/{id}Ottieni un'email specifica
POST/emailsInvia una nuova email
PUT/emails/{id}Aggiorna metadati email
DELETE/emails/{id}Elimina un'email

Contatti

Gestisci la tua rubrica e le informazioni di contatto

GET/contactsElenca tutti i contatti
GET/contacts/{id}Ottieni un contatto specifico
POST/contactsCrea un nuovo contatto
PUT/contacts/{id}Aggiorna un contatto
DELETE/contacts/{id}Elimina un contatto

Cartelle ed Etichette

Organizza le email con cartelle ed etichette

GET/foldersElenca tutte le cartelle
POST/foldersCrea una nuova cartella
GET/labelsElenca tutte le etichette
POST/labelsCrea una nuova etichetta

Webhook

Ricevi notifiche in tempo reale per gli eventi

GET/webhooksElenca iscrizioni webhook
POST/webhooksCrea un webhook
DELETE/webhooks/{id}Elimina un webhook

Account

Gestisci impostazioni e preferenze dell'account

GET/accountOttieni dettagli account
PUT/accountAggiorna impostazioni account
GET/account/usageOttieni statistiche uso API

Allegati

Carica e scarica allegati email

GET/attachments/{id}Scarica allegato
POST/attachmentsCarica allegato
DELETE/attachments/{id}Elimina allegato

SDK Ufficiali

Usa le nostre librerie ufficiali per integrare piu velocemente.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Limiti di Frequenza

I limiti di frequenza API si basano sul tuo livello di abbonamento.

LivelloLimite FrequenzaLimite Giornaliero
Gratuito100 richieste/min1.000/giorno
Pro1.000 richieste/min50.000/giorno
Business5.000 richieste/min250.000/giorno
EnterprisePersonalizzatoIllimitato

Autenticazione

Tutte le richieste API richiedono autenticazione tramite chiave API o token OAuth 2.0. Includi le tue credenziali nell'header Authorization.

Authorization: Bearer YOUR_API_KEY

Pronto per iniziare?

Crea una chiave API e inizia a costruire la tua integrazione oggi.