Referencia de API
Crea integraciones potentes con la API de Icebox. Accede a correos, contactos y más de forma programática.
Diseño RESTful
URLs limpias y predecibles con métodos HTTP estándar
Seguro por Defecto
Opciones de autenticación OAuth 2.0 y clave API
Webhooks en Tiempo Real
Recibe notificaciones instantáneas cuando ocurren eventos
SDKs Oficiales
Bibliotecas para lenguajes y frameworks populares
https://api.icebox.cool/v1Inicio Rápido
Comienza a usar la API de Icebox en minutos.
// 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 -X GET "https://api.icebox.cool/v1/emails" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"{
"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
}
}Endpoints de API
Explora los endpoints disponibles organizados por recurso.
Correos
Envía, recibe y gestiona mensajes de correo
/emailsListar todos los correos/emails/{id}Obtener un correo especifico/emailsEnviar un nuevo correo/emails/{id}Actualizar metadatos del correo/emails/{id}Eliminar un correoContactos
Gestiona tu libreta de direcciones e información de contacto
/contactsListar todos los contactos/contacts/{id}Obtener un contacto especifico/contactsCrear un nuevo contacto/contacts/{id}Actualizar un contacto/contacts/{id}Eliminar un contactoCarpetas y Etiquetas
Organiza correos con carpetas y etiquetas
/foldersListar todas las carpetas/foldersCrear una nueva carpeta/labelsListar todas las etiquetas/labelsCrear una nueva etiquetaWebhooks
Recibe notificaciones en tiempo real de eventos
/webhooksListar suscripciones de webhook/webhooksCrear un webhook/webhooks/{id}Eliminar un webhookCuenta
Gestiona configuración y preferencias de cuenta
/accountObtener detalles de cuenta/accountActualizar configuración de cuenta/account/usageObtener estadísticas de uso de la APIAdjuntos
Sube y descarga adjuntos de correo
/attachments/{id}Descargar adjunto/attachmentsSubir adjunto/attachments/{id}Eliminar adjuntoSDKs Oficiales
Usa nuestras bibliotecas oficiales para integrar más rápido.
JavaScript / TypeScript
npm install @icebox/sdkPython
pip install icebox-sdkRuby
gem install iceboxGo
go get github.com/icebox/sdk-goLimites de Tasa
Los límites de tasa de la API se basan en tu nivel de suscripción.
Autenticación
Todas las solicitudes de API requieren autenticación vía clave API o token OAuth 2.0. Incluye tus credenciales en el encabezado Authorization.
Authorization: Bearer YOUR_API_KEY¿Listo para comenzar?
Crea una clave API y comienza a construir tu integración hoy.