Motyw
Dokumentacja dla programistów

Dokumentacja API

Tworzenie potężnych integracji z Icebox API. Programowy dostęp do e-maili, kontaktów i nie tylko.

Uzyskaj klucz APIPrzewodnik szybkiego startu

Projekt RESTful

Czyste, przewidywalne adresy URL i standardowe metody HTTP

Domyslnie bezpieczny

Opcje uwierzytelniania OAuth 2.0 i klucz API

Webhooks w czasie rzeczywistym

Otrzymuj natychmiastowe powiadomienia o zdarzeniach

Oficjalne SDK

Biblioteki dla popularnych języków i frameworków

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

Szybki start

Zacznij korzystać z Icebox API w kilka minut.

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

Punkty koncowe API

Przeglądaj dostępne punkty końcowe zorganizowane według zasobów.

E-maile

Wysyłaj, odbieraj i zarządzaj wiadomościami e-mail

GET/emailsLista wszystkich e-maili
GET/emails/{id}Pobierz konkretny e-mail
POST/emailsWyślij nowy e-mail
PUT/emails/{id}Aktualizuj metadane e-maila
DELETE/emails/{id}Usuń e-mail

Kontakty

Zarządzaj książką adresową i informacjami kontaktowymi

GET/contactsLista wszystkich kontaktów
GET/contacts/{id}Pobierz konkretny kontakt
POST/contactsUtwórz nowy kontakt
PUT/contacts/{id}Aktualizuj kontakt
DELETE/contacts/{id}Usuń kontakt

Foldery i etykiety

Organizuj e-maile za pomocą folderów i etykiet

GET/foldersLista wszystkich folderów
POST/foldersUtwórz nowy folder
GET/labelsLista wszystkich etykiet
POST/labelsUtwórz nową etykietę

Webhooki

Otrzymuj powiadomienia o zdarzeniach w czasie rzeczywistym

GET/webhooksLista subskrypcji webhook
POST/webhooksUtwórz webhook
DELETE/webhooks/{id}Usuń webhook

Konto

Zarządzaj ustawieniami i preferencjami konta

GET/accountPobierz szczegóły konta
PUT/accountAktualizuj ustawienia konta
GET/account/usagePobierz statystyki uzycia API

Załączniki

Przesyłaj i pobieraj załączniki e-mail

GET/attachments/{id}Pobierz załącznik
POST/attachmentsPrześlij załącznik
DELETE/attachments/{id}Usuń załącznik

Oficjalne SDK

Użyj naszych oficjalnych bibliotek do szybszej integracji.

JavaScript / TypeScript

npm install @icebox/sdk

Python

pip install icebox-sdk

Ruby

gem install icebox

Go

go get github.com/icebox/sdk-go

Limity zapytan

Limity API zaleza od poziomu subskrypcji.

PoziomLimit zapytanDzienny limit
Darmowy100 zapytan/min1 000/dzień
Pro1 000 zapytan/min50 000/dzień
Biznes5 000 zapytan/min250 000/dzień
EnterpriseNiestandardowyBez limitu

Uwierzytelnianie

Wszystkie żądania API wymagają uwierzytelnienia za pomocą klucza API lub tokena OAuth 2.0. Dołącz swoje dane uwierzytelniające w nagłówku Authorization.

Authorization: Bearer YOUR_API_KEY

Gotowy, żeby zacząć?

Utwórz klucz API i zacznij budować integracje już dziś.

Uzyskaj klucz APIPrzeczytaj pełną dokumentację →
← Powrót do strony głównej