Přejít na obsah
Dokumentace

Reference

Oficiální knihovny Emailitu pro Node.js, PHP, Laravel, Python, Ruby, Go, Javu, .NET a Rust, balíček MCP a volání API přes obyčejné HTTP.

Aktualizováno 1. 10. 2026

Emailit spravuje open-source klientské knihovny pro devět jazyků a frameworků. Každá obaluje REST API, má typované chyby a používá stejné názvy zdrojů, jaké vidíte v referenci API. Pokud váš jazyk v seznamu není, poslouží jakýkoli HTTP klient.

Oficiální knihovny

Všechny knihovny mají licenci MIT a publikujeme je z github.com/emailit.

Jazyk Balíček Instalace Požadavky Zdrojový kód
Node.js @emailit/node npm install @emailit/node Node.js 18+ emailit-node
PHP emailit/emailit-php composer require emailit/emailit-php PHP 8.1+ emailit-php
Laravel emailit/emailit-laravel composer require emailit/emailit-laravel Laravel 10, 11 nebo 12 emailit-laravel
Python emailit pip install emailit Python 3.7+ emailit-python
Ruby emailit bundle add emailit Ruby 3.0+ emailit-ruby
Go github.com/emailit/emailit-go/v2 go get github.com/emailit/emailit-go/v2 Go 1.21+ emailit-go
Java com.emailit:emailit-java Maven nebo Gradle, viz níže Java 11+ emailit-java
.NET Emailit dotnet add package Emailit .NET 8+ emailit-dotnet
Rust emailit cargo add emailit Rust 1.85+ a Tokio emailit-rust

V Javě přidejte závislost s nejnovější verzí uvedenou v repozitáři:

pom.xml
<dependency>
  <groupId>com.emailit</groupId>
  <artifactId>emailit-java</artifactId>
  <version>VERSION</version>
</dependency>
build.gradle
implementation 'com.emailit:emailit-java:VERSION'

Odešlete e-mail

Každá knihovna při vytvoření klienta přijímá váš API klíč. Načtěte ho z proměnné prostředí, místo abyste ho zapisovali přímo do kódu.

JavaScript
import { Emailit } from '@emailit/node';

const emailit = new Emailit(process.env.EMAILIT_API_KEY);

const email = await emailit.emails.send({
  from: 'Acme <hello@acme.com>',
  to: 'ada@example.com',
  subject: 'Welcome to Acme',
  html: '<p>Thanks for signing up.</p>',
});

console.log(email.id);

Adresa from musí být na ověřené odesílací doméně. Dokud váš workspace nemá produkční přístup, můžete odesílat jen na e-mailové adresy účtů členů workspace.

Co knihovny pokrývají

Každá knihovna zpřístupňuje stejné služby: e-maily, domény, API klíče, seznamy kontaktů, odběratele, šablony, blokované adresy, ověření e-mailů, seznamy k ověření, webhooky, kontakty a události. Chyby se vyhazují jako typované výjimky nebo vracejí jako chybové hodnoty, například chyba autentizace pro 401, chyba limitu rychlosti pro 429 a chyba validace pro 422, takže můžete každý případ ošetřit zvlášť.

Některé novější endpointy knihovny zatím nepokrývají, mimo jiné přeposlání e-mailu, kampaně, automatizace, formuláře a DMARC reporty. Knihovny také nenastavují hlavičku Idempotency-Key. V těchto případech volejte endpoint přes HTTP se stejným API klíčem, jak ukazuje příklad níže.

Nastavení pro konkrétní frameworky, včetně mail transportů, rout pro webhooky a konfigurace SMTP, najdete v návodech pro frameworky: Node.js, Next.js, Nuxt, Laravel, PHP, Python, Ruby on Rails, Go, Java, .NET a WordPress.

Balíček s MCP serverem

Open-source balíček @emailit/emailit-mcp spouští MCP server na vašem počítači, aby AI asistenti mohli volat Emailit s vaším API klíčem:

Terminal
npx -y @emailit/emailit-mcp

Většina lidí ho nepotřebuje: hostovaný server na https://api.emailit.com/mcp nevyžaduje žádnou instalaci. Obě možnosti porovnává stránka Lokální spuštění MCP serveru.

@emailit/js je jiný balíček: je to skript pro prohlížeč, který na vašem webu zobrazuje formuláře Emailitu, ne klient API.

Používejte API přes HTTP

Knihovnu nepotřebujete. Poslouží jakýkoli HTTP klient, který umí posílat JSON:

  • Základní URL: https://api.emailit.com/v2
  • Hlavičky: Authorization: Bearer <your API key> a Content-Type: application/json
  • Těla požadavků a odpovědi: JSON

Například přeposlání e-mailu s idempotenčním klíčem z Node.js bez SDK:

JavaScript
const response = await fetch('https://api.emailit.com/v2/emails/em_4K6oASS7KP9ztzWmSN9ndEu13HW/forward', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': 'forward-order-1042',
  },
  body: JSON.stringify({ to: 'support@acme.com' }),
});

if (!response.ok) {
  throw new Error(`Emailit returned ${response.status}: ${await response.text()}`);
}

Než si napíšete vlastního klienta, přečtěte si stránky Chyby a Limity rychlosti, abyste správně ošetřili odpovědi 4xx a retry-after. Pokud vaše aplikace už umí SMTP, můžete API úplně vynechat a použít SMTP relay.

Komunitní knihovny

Emailit nespravuje žádné knihovny mimo seznam výše. Pokud najdete nebo vytvoříte knihovnu pro jiný jazyk nebo framework, zkontrolujte její kód dřív, než jí dáte API klíč, a dejte přednost klíči jen pro odesílání omezenému na jednu doménu. Pokud chcete, abychom ji tu zmínili, dejte nám vědět na support@emailit.com nebo na Discordu.

Základní URL, ID, chyby, stránkování a limity rychlosti.
Vytvořte klíč, který vaše knihovna potřebuje.
Šablony, přílohy, plánování a měření.
Ověřte, že požadavky webhooků přicházejí z Emailitu.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.