Motyw
Dokumentacja dla programistow

Dokumentacja API

Tworzenie poteznych integracji z Icebox API. Programowy dostep do e-maili, kontaktow i nie tylko.

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 jezykow i frameworkow

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

Szybki start

Zacznij korzystac 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

Przegladaj dostepne punkty koncowe zorganizowane wedlug zasobow.

E-maile

Wysylaj, odbieraj i zarzadzaj wiadomosciami e-mail

GET/emailsLista wszystkich e-maili
GET/emails/{id}Pobierz konkretny e-mail
POST/emailsWyslij nowy e-mail
PUT/emails/{id}Aktualizuj metadane e-maila
DELETE/emails/{id}Usun e-mail

Kontakty

Zarzadzaj ksiazka adresowa i informacjami kontaktowymi

GET/contactsLista wszystkich kontaktow
GET/contacts/{id}Pobierz konkretny kontakt
POST/contactsUtworz nowy kontakt
PUT/contacts/{id}Aktualizuj kontakt
DELETE/contacts/{id}Usun kontakt

Foldery i etykiety

Organizuj e-maile za pomoca folderow i etykiet

GET/foldersLista wszystkich folderow
POST/foldersUtworz nowy folder
GET/labelsLista wszystkich etykiet
POST/labelsUtworz nowa etykiete

Webhooki

Otrzymuj powiadomienia o zdarzeniach w czasie rzeczywistym

GET/webhooksLista subskrypcji webhook
POST/webhooksUtworz webhook
DELETE/webhooks/{id}Usun webhook

Konto

Zarzadzaj ustawieniami i preferencjami konta

GET/accountPobierz szczegoly konta
PUT/accountAktualizuj ustawienia konta
GET/account/usagePobierz statystyki uzycia API

Zalaczniki

Przesylaj i pobieraj zalaczniki e-mail

GET/attachments/{id}Pobierz zalacznik
POST/attachmentsPrzeslij zalacznik
DELETE/attachments/{id}Usun zalacznik

Oficjalne SDK

Uzyj 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/dzien
Pro1 000 zapytan/min50 000/dzien
Biznes5 000 zapytan/min250 000/dzien
EnterpriseNiestandardowyBez limitu

Uwierzytelnianie

Wszystkie zadania API wymagaja uwierzytelnienia za pomoca klucza API lub tokena OAuth 2.0. Dolacz swoje dane uwierzytelniajace w naglowku Authorization.

Authorization: Bearer YOUR_API_KEY

Gotowy, zeby zaczac?

Utworz klucz API i zacznij budowac integracje juz dzis.