Aller au contenu
Docs

Référence

Les bibliothèques officielles d’Emailit pour Node.js, PHP, Laravel, Python, Ruby, Go, Java, .NET et Rust, le paquet MCP et la façon d’appeler l’API en HTTP simple.

Mis à jour le 1 oct. 2026

Emailit maintient des bibliothèques clientes open source pour neuf langages et frameworks. Chacune encapsule l’API REST avec des erreurs typées et les mêmes noms de ressources que dans la référence de l’API. Si votre langage n’y figure pas, n’importe quel client HTTP fonctionne.

Bibliothèques officielles

Toutes les bibliothèques sont sous licence MIT et publiées depuis github.com/emailit.

Langage Paquet Installation Prérequis Source
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 ou 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 ou Gradle, voir ci-dessous Java 11+ emailit-java
.NET Emailit dotnet add package Emailit .NET 8+ emailit-dotnet
Rust emailit cargo add emailit Rust 1.85+ et Tokio emailit-rust

Pour Java, ajoutez la dépendance avec la dernière version indiquée dans le dépôt :

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

Envoyer un e-mail

Chaque bibliothèque prend votre clé API à la création du client. Chargez-la depuis une variable d’environnement plutôt que de l’écrire en dur dans le code.

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);

L’adresse from doit appartenir à un domaine d’envoi vérifié. Tant que votre espace de travail n’a pas l’accès production, vous ne pouvez envoyer qu’aux adresses e-mail de compte des membres de l’espace de travail.

Ce que couvrent les bibliothèques

Chaque bibliothèque expose les mêmes services : e-mails, domaines, clés API, listes de contacts, abonnés, modèles, adresses bloquées, vérifications d’e-mails, listes de vérification d’e-mails, webhooks, contacts et événements. Les erreurs sont levées sous forme d’exceptions typées ou renvoyées sous forme de valeurs d’erreur, par exemple une erreur d’authentification pour 401, une erreur de limite de débit pour 429 et une erreur de validation pour 422 : vous pouvez ainsi traiter chaque cas séparément.

Certains endpoints plus récents ne sont pas encore couverts, notamment le transfert d’un e-mail, les campagnes, les automatisations, les formulaires et les rapports DMARC. Les bibliothèques ne définissent pas non plus l’en-tête Idempotency-Key. Dans ces cas, appelez l’endpoint en HTTP avec la même clé API, comme ci-dessous.

Pour la configuration propre à chaque framework, y compris les transports d’e-mail, les routes de webhook et la configuration SMTP, consultez les guides des frameworks : Node.js, Next.js, Nuxt, Laravel, PHP, Python, Ruby on Rails, Go, Java, .NET et WordPress.

Paquet du serveur MCP

Le paquet open source @emailit/emailit-mcp exécute un serveur MCP sur votre machine pour que les assistants IA puissent appeler Emailit avec votre clé API :

Terminal
npx -y @emailit/emailit-mcp

La plupart des utilisateurs n’en ont pas besoin : le serveur hébergé sur https://api.emailit.com/mcp ne nécessite aucune installation. Comparez les deux dans Exécuter le serveur MCP en local.

@emailit/js est un autre paquet : c’est le script de navigateur qui affiche les formulaires Emailit sur votre site, pas un client de l’API.

Utiliser l’API en HTTP

Vous n’avez pas besoin d’une bibliothèque. N’importe quel client HTTP capable d’envoyer du JSON fonctionne :

  • URL de base : https://api.emailit.com/v2
  • En-têtes : Authorization: Bearer <your API key> et Content-Type: application/json
  • Corps et réponses : JSON

Par exemple, pour transférer un e-mail avec une clé d’idempotence depuis Node.js sans le 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()}`);
}

Lisez Erreurs et Limites de débit avant de développer votre propre client, afin de traiter correctement les réponses 4xx et retry-after. Si votre application parle déjà SMTP, vous pouvez aussi vous passer complètement de l’API et utiliser le relais SMTP.

Bibliothèques de la communauté

Emailit ne maintient pas d’autres bibliothèques que celles de la liste ci-dessus. Si vous en trouvez ou en développez une pour un autre langage ou framework, examinez son code avant de lui confier une clé API, et privilégiez une clé Sending Only limitée à un domaine. Écrivez-nous à support@emailit.com ou sur Discord si vous souhaitez qu’elle soit mentionnée ici.

URL de base, ID, erreurs, pagination et limites de débit.
Créez la clé dont votre bibliothèque a besoin.
Modèles, pièces jointes, programmation et suivi.
Vérifiez que les requêtes de webhook proviennent d’Emailit.

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.