API IMAP : Le guide du développeur

Table des matières
Vue d'ensemble
1
Introduction à l'API IMAP
2
Pourquoi utiliser une API IMAP ?
3
API IMAP d'Unipile
Fonctionnalités
4
Comment l'IMAP améliore la messagerie électronique
5
Authentification et sécurité
6
Fonctionnalités de l'API IMAP
d'Intégration
7
Configuration étape par étape
8
Unipile vs Intégration autonome
FAQ
9
FAQ
Table des matières
Vue d'ensemble
1
Introduction à l'API IMAP
2
Pourquoi utiliser une API IMAP ?
3
API IMAP d'Unipile
Fonctionnalités
4
Comment l'IMAP améliore la messagerie électronique
5
Authentification et sécurité
6
Fonctionnalités de l'API IMAP
d'Intégration
7
Configuration étape par étape
8
Unipile vs Intégration autonome
FAQ
9
FAQ
Vue d'ensemble

Introduction aux solutions API IMAP

Qu'est-ce que l'IMAP et le protocole IMAP ?

IMAP (Internet Message Access Protocol) est un protocole de messagerie qui permet aux utilisateurs d'accéder à leurs e-mails depuis un serveur de messagerie sans les télécharger. Comprendre le fonctionnement d'une API IMAP est essentiel pour créer des intégrations de messagerie robustes. Avec l'API IMAP d'Unipile, les développeurs peuvent améliorer la gestion des e-mails, en garantissant une synchronisation en temps réel entre l'application et les comptes de messagerie des utilisateurs, de manière efficace.

Simplifier l'IMAP avec Unipile

IMAP ne fournit pas d'API basée sur HTTP, obligeant les développeurs à travailler directement avec ses commandes de protocole et ses complexités. L'API IMAP de Unipile transforme ce protocole complexe en une API accessible basée sur HTTP, avec prise en charge des webhooks et une nouvelle valeur. En utilisant Unipile, les développeurs peuvent contourner les défis liés à l'implémentation de connexions IMAP brutes tout en assurant une synchronisation efficace et en temps réel entre l'application et les comptes de messagerie de l'utilisateur.

Fournisseurs et fonctionnalités IMAP pris en charge

L'API IMAP d'Unipile prend en charge un large éventail de fournisseurs de messagerie, garantissant ainsi flexibilité et compatibilité pour divers cas d'utilisation. Voici quelques-uns des fournisseurs pris en charge :

FastMail
Zoho Mail
GoDaddy Mail
Yandex.Mail
Courrier AOL
Bluehost
Mail.com
EarthLink
Hover.com
GMX
IONOS

Ce ne sont là que quelques-uns des fournisseurs IMAP qui peuvent être intégrés à Unipile, offrant une flexibilité et une fonctionnalité robuste pour diverses plates-formes de messagerie.

Guide complet de l'API d'e-mail
Apprenez comment Gmail, Outlook et IMAP collaborent sous une API REST unifiée.
Lisez le guide

Qu'est-ce qu'une API IMAP ?

Un API IMAP est une interface REST qui abstrait la complexité du protocole IMAP, permettant aux développeurs d'interagir avec les serveurs de messagerie à l'aide de simples requêtes HTTP au lieu de commandes IMAP brutes. Elle gère la gestion des connexions, l'authentification et l'analyse des données, exposant des opérations de messagerie telles que la récupération de messages, la gestion des dossiers et l'envoi d'e-mails via des points de terminaison d'API standard.

Dépréciation de l'authentification de base de Microsoft (2026) : Microsoft retire l'authentification de base pour IMAP et SMTP. Les applications utilisant IMAP brut avec des identifiants nom d'utilisateur/mot de passe cesseront de fonctionner. Unipile gère OAuth2 automatiquement pour Microsoft 365 et Gmail, de sorte que votre intégration continue de fonctionner sans modifications de code. En savoir plus sur l'authentification sécurisée.

API IMAP vs Protocole IMAP direct

CritèresIMAP directAPI IMAP (Unipile)
Connaissance du protocoleRequis (RFC 3501)Pas nécessaire
Gestion de la connexionManuel (prises, IDLE, reconnexion)Géré automatiquement
AuthentificationIdentifiants bruts ou OAuth2 personnaliséAuthentification hébergée (OAuth2 + IMAP)
Mises à jour en temps réelIMAP IDLE (complexe)Webhooks (HTTP POST)
Support multi-fournisseursCode personnalisé par fournisseurUne API pour tous les fournisseurs
Le temps d'intégrationDes semaines aux moisHeures en jours
MaintenanceEn cours (changements de fournisseur, mises à jour d'authentification)Zéro (géré par Unipile)
Pourquoi l'API IMAP

Pourquoi utiliser une API IMAP ?

Une API IMAP simplifie la gestion des e-mails en donnant aux développeurs la possibilité d'accéder et de gérer les e-mails entrants par programme. Elle permet une synchronisation transparente des messages sur plusieurs plateformes et applications utilisateur, garantissant que les utilisateurs ont toujours accès aux derniers e-mails. De plus, elle réduit la complexité de la gestion des protocoles de messagerie, ce qui facilite la création d'applications robustes intégrées à la messagerie.

Synchronisation en temps réel
Maintenez vos e-mails synchronisés sur tous vos appareils et plateformes en temps réel, sans aucune actualisation manuelle ni délai de son-dage.
Accès programmatique aux e-mails
Accédez et gérez les e-mails entrants par programme via une interface HTTP propre au lieu des commandes brutes du protocole IMAP.
Une intégration plus rapide
Intégrez la fonctionnalité de messagerie IMAP dans votre application en aussi peu que deux jours, en évitant la complexité de l'implémentation brute du protocole.
Prise en charge multi-fournisseurs
Connectez n'importe quel fournisseur de messagerie compatible IMAP - de FastMail à Zoho Mail en passant par les serveurs de messagerie d'entreprise personnalisés.
Support des Webhooks
Recevez des notifications en temps réel pour les nouveaux e-mails et les événements de la boîte de réception via des webhooks, permettant ainsi des flux de travail réactifs basés sur les e-mails.
Sécurisé par défaut
L'authentification hébergée intégrée avec chiffrement de bout en bout signifie que les informations d'identification ne sont jamais stockées directement dans votre application.
API IMAP Unipile

API IMAP d'Unipile : Une intégration d'emails robuste

Aperçu de l'API d'e-mail d'Unipile

Unipile propose une puissante API IMAP qui intègre facilement les fonctionnalités de messagerie électronique dans les applications. Elle permet la synchronisation en temps réel des courriels, la récupération efficace des courriels et des mécanismes d'authentification sécurisés.

IMAP est l'un des trois protocoles de messagerie pris en charge par Unipile. Intégration d'API d'e-mail unifiée, aux côtés de l'API Gmail et de l'API Microsoft Graph.

Logo GmailAPI Gmail
Logo OutlookMicrosoft Graph API
Logo IMAPAPI IMAP

Principaux avantages de l'utilisation de l'API IMAP d'Unipile

Authentification hébergée avec identifiants
Fournit des mécanismes de connexion sécurisés en permettant aux utilisateurs de s'authentifier à l'aide de leurs informations d'identification sans les stocker directement dans l'application.
Synchronisation d'e-mails transparente
Synchronisation en temps réel entre plusieurs appareils, garantissant aux utilisateurs un accès constant aux derniers messages.
Analyse d'e-mails automatisée
Extrayez des données structurées d'e-mails sans effort, permettant une automatisation puissante et des intégrations de flux de travail.

Vue d'ensemble

Simplifier l'IMAP avec Unipile

IMAP ne fournit pas d'API basée sur HTTP, obligeant les développeurs à travailler directement avec ses commandes de protocole et ses complexités. L'API IMAP d'Unipile transforme ce protocole complexe en une API accessible basée sur HTTP, complet avec prise en charge des webhooks et synchronisation en temps réel.

En utilisant Unipile, les développeurs peuvent surmonter les défis liés à l'implémentation de connexions IMAP brutes tout en garantissant une synchronisation efficace et en temps réel entre l'application et les comptes de messagerie de l'utilisateur.

Fournisseurs et fonctionnalités IMAP pris en charge

L'API IMAP d'Unipile prend en charge un large éventail de fournisseurs de messagerie, garantissant flexibilité et compatibilité pour divers cas d'utilisation :

FastMail Zoho Mail GoDaddy Mail Yandex.Mail Courrier AOL Bluehost Mail.com EarthLink Hover.com GMX IONOS Yahoo Mail Tout serveur IMAP conforme aux normes

Voici quelques-uns des fournisseurs IMAP qui peuvent être intégrés à Unipile, offrant ainsi flexibilité et fonctionnalités robustes pour diverses plateformes de messagerie électronique.

Fonctionnalité

Comment l'API IMAP améliore la fonctionnalité du courrier électronique

L'API IMAP joue un rôle crucial dans les applications modernes de messagerie électronique en permettant une synchronisation transparente, une gestion efficace du courrier électronique et une communication sécurisée. Grâce aux commandes IMAP, les développeurs peuvent récupérer, organiser et envoyer des courriels tout en garantissant un accès en temps réel et une grande intégrité des données.

Synchronisation des e-mails et accès en temps réel

Avec l'API IMAP d'Unipile, les e-mails sont synchronisés en temps réel sur les appareils, permettant une gestion de la boîte de réception à jour et la récupération de l'intégralité de l'historique des e-mails sans aucune limitation de temps.

Gestion des dossiers et des étiquettes à l'aide de commandes IMAP

Les utilisateurs peuvent créer, supprimer et organiser les courriels à l'aide d'étiquettes et de dossiers pour une meilleure catégorisation et l'automatisation du flux de travail.

Envoi d'e-mails via IMAP

L'API IMAP d'Unipile permet aux développeurs d'envoyer des messages directement à l'aide de commandes IMAP, assurant ainsi une transmission d'e-mails transparente tout en maintenant la synchronisation sur tous les appareils connectés.

Sécurité

Authentification et sécurité de l'API IMAP avec Unipile

Garantir une authentification sécurisée et la protection des données est crucial lors de l'intégration de solutions API IMAP. Unipile fournit des mécanismes d'authentification robustes et des normes de cryptage pour protéger les communications par courrier électronique.

Authentification hébergée pour IMAP

Unipile simplifie l'authentification en permettant aux utilisateurs de connecter leurs comptes de messagerie par le biais d'une interface hébergée sécurisée, éliminant ainsi le besoin de stocker des informations d'identification dans votre application.

Chiffrement et confidentialité des données

La sécurité des données est une priorité grâce au cryptage de bout en bout, ce qui garantit que le contenu des courriels reste confidentiel et protégé contre tout accès non autorisé.

d'Intégration

Guide étape par étape pour configurer l'API IMAP d'Unipile

Ce guide vous aidera à intégrer l'API IMAP d'Unipile dans votre application pour une gestion des e-mails transparente. Suivez les étapes ci-dessous pour vous authentifier et commencer à utiliser l'API IMAP efficacement. Pour les développeurs Python, consultez notre Exemples de code Python pour envoyer des e-mails via l'API unifiée.

1

Étape 1 : Obtenir l'accès à l'API

Créer un compte sur Unipile

Avant de commencer, assurez-vous que vous avez :

Un enregistrement Compte Unipile.
Accès aux identifiants de l'API Unipile (ID client, secret client et jeton d'accès).

Générer les informations d'identification de l'API

Connectez-vous à votre tableau de bord de développeur Unipile.
Naviguez vers la section Clés API.
Créez une nouvelle clé API et notez l'ID du client, le secret du client et le jeton d'accès.
2

Étape 2 : Configuration des paramètres IMAP

Pour connecter votre application à un compte de messagerie via IMAP, vous avez besoin des éléments suivants :

Utilisateur IMAP : L'adresse e-mail que vous souhaitez intégrer
Mot de passe IMAP : Le mot de passe ou le mot de passe d'application pour le compte de messagerie
Hôte IMAP : L'adresse du serveur de messagerie
3

Étape 3 : Authentifiez-vous auprès de l'API IMAP d'Unipile

Point final de l'API pour l'authentification

Point de terminaison
POST https://{subdomain}.unipile.com:{port}/api/v1/accounts

Exemple de demande d'API (cURL) :

cURL
curl --request POST \ --url https://{VOTRE_DSN}/api/v1/accounts \ --header 'X-API-KEY: {VOTRE_JETON_D_ACCÈS}' \ --en-tête 'content-type : application/json' \ --données '{ "provider": "MAIL", "imap_user": "votre\_email@example.com", "imap_password": "votre\_mot\_de\_passe", "imap_host": "imap.votrefournisseur.com", "imap_port": 993, "imap_encryption": "SSL" }'

Remplacez les espaces réservés par vos identifiants réels et les détails du serveur :

{VOTRE_DSN} : Le domaine de votre instance Unipile.
{VOTRE_JETON_D_ACCÈS}: Votre jeton d'accès API.
Paramètres liés au courrier électronique (imap_user, imap_password, imap_host, etc.) avec les détails de votre compte.
4

Étape 4 : Test de la connexion IMAP

Une fois que la demande a abouti, Unipile répondra avec un identifiant de compte et des détails de connexion. Utilisez ces informations pour vérifier l'intégration :

Exemple de réponse :

Réponse JSON
{ "objet": "CompteCréé", "account_id": "identifiant_unique_du_compte", "statut": "connecté" }
5

Étape 5 : Récupérer les messages électroniques à l'aide des commandes IMAP

Après authentification, utilisez l'API Unipile pour récupérer les e-mails par programme.

Récupérer des courriels (exemple) :

SDK Node.js
import { UnipileClient } from "unipile-node-sdk"; const client = new UnipileClient("votre_url_de_base", "votre_jeton_d_accès"); async function fetchEmails() { essayer { const response = await client.account.getAll(); console.log(response); } attraper (erreur) { console.error(erreur); } } fetchEmails();
Lister tous les e-mails : Cette fonction permet de récupérer une liste d'e-mails à partir du compte d'un utilisateur, en appliquant divers filtres pour rechercher des messages spécifiques en fonction de critères tels que l'expéditeur, la date ou le contenu. Elle simplifie le processus de recherche et d'organisation des e-mails, permet de gagner du temps en éliminant le tri manuel et améliore l'engagement de l'utilisateur en affichant rapidement la correspondance pertinente.
6

Étape 6 : Dépannage des erreurs courantes

Problèmes communs

401 Non autorisé
Vérifiez vos informations d'identification d'API et votre jeton d'accès.
Hôte IMAP non valide
Assurez-vous que les détails du serveur IMAP sont corrects.
Erreurs de délai d'attente
Vérifier la connectivité réseau et la disponibilité du serveur.

Conseils de débogage

Enregistrez la réponse d'erreur complète à des fins de diagnostic.
Utilisez Documentation pour les développeurs d'Unipile et un soutien pour une aide supplémentaire.
API IMAP

Caractéristiques des solutions API IMAP

Intégration des fournisseurs de messagerie Gmail, Outlook et IMAP via une API unifiée unique. Envoyez, recevez, organisez et suivez les e-mails sur tous les principaux fournisseurs avec des points de terminaison cohérents.

Explorer tous les points finaux
Gmail Outlook IMAP
Connexion au compteCompte
Envoyer / RecevoirEnvoyer
Organiser
Webhooks

Connexion au compte

3 points finaux disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Hosted Auth : Authentification par email en marque blanche
Connecter l'utilisateur avec des credentials
Utiliser l'écran OAuth de votre application

Envoyer / Recevoir

3 points finaux disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Envoyer un email
Répondre à un email
Lister des emails

Organiser

4 points finaux disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Supprimer un email
Déplacer un email
Lister des dossiers
Récupérer un dossier

Webhooks

2 événements disponibles

Gmail Gmail
Outlook Outlook
IMAP IMAP
Nouvel Email
Suivi des ouvertures et des clics
Comparaison

Unipile ou auto-intégration : Pourquoi Unipile est le meilleur choix

Lorsque vous intégrez des fonctionnalités de messagerie dans votre application, vous pourriez être confronté au choix entre utiliser une solution prête à l'emploi comme Unipile ou développer votre propre auto-intégration. Bien que cette dernière puisse sembler attrayante pour un contrôle total, Unipile (un leader Nylas alternative) offre des avantages considérables en termes de temps, d'effort de développement et de fiabilité globale. Ici, nous comparons Unipile à une auto-intégration pour les solutions d'API IMAP.

Critères API IMAP Unipile Auto-intégration
Le temps d'intégration
Aussi peu que 2 jours
Des semaines aux mois
Coût de développement
Infrastructure préfabriquée
Ressources importantes requises
La delivrabilité
Fonctionnalités de fiabilité intégrées
Risques de mauvaise configuration du serveur
Sécurité
Chiffrement de bout en bout inclus
Implémentation manuelle requise
Évolutivité
Échelles sans effort
Coûts d'exploitation élevés

Commencez à intégrer IMAP en seulement deux jours

Facilité de mise en œuvre
Unipile
Avec Unipile, les développeurs peuvent intégrer des solutions d'API IMAP en aussi peu que deux jours. Son API simplifiée et sa documentation robuste facilitent grandement le processus, même pour les flux de travail d'e-mails complexes.
Auto-intégration
Construire sa propre auto-intégration à partir de zéro nécessite une compréhension approfondie des extensions IMAP, des configurations de serveur et des protocoles de sécurité.
Temps et coûts de développement
Unipile
En tirant parti de l'infrastructure pré-construite d'Unipile, les entreprises peuvent économiser un temps et des coûts de développement considérables, permettant aux équipes de se concentrer sur les fonctionnalités principales du produit.
Auto-intégration
L'auto-intégration exige des ressources considérables pour le développement, les tests et la maintenance. Les mises à jour continues pour gérer les changements des fournisseurs ajoutent une charge supplémentaire.
Fiabilité et performance
Unipile
Unipile garantit une fiabilité et des performances élevées grâce à des fonctionnalités intégrées telles que la récupération efficace des e-mails, la gestion des dossiers et la synchronisation en temps réel.
Auto-intégration
Les auto-intégrations personnalisées rencontrent souvent des problèmes de fiabilité dus à des mauvaises configurations de serveur, des limites de débit, la gestion des erreurs et les extensions IMAP.
La sécurité et la conformité
Unipile
Unipile offre une authentification sécurisée, un chiffrement de bout en bout et la conformité avec les principaux fournisseurs de messagerie tels que Gmail et Outlook.
Auto-intégration
Les développeurs doivent implémenter manuellement les protocoles de sécurité, ce qui augmente le risque de vulnérabilités, en particulier avec les extensions IMAP.
Scalabilité et flexibilité
Unipile
Unipile s'adapte avec aisance pour gérer plusieurs fournisseurs d'e-mails et comptes liés. Ses API sont conçues pour s'adapter aux divers besoins de l'entreprise.
Auto-intégration
La mise à l'échelle d'une auto-intégration nécessite des frais généraux de développement et d'exploitation importants, en particulier lorsqu'il s'agit d'extensions IMAP.
Prêt à intégrer
Commencez à utiliser l'API IMAP en seulement deux jours

L'API IMAP d'Unipile offre aux développeurs un moyen efficace d'intégrer les fonctionnalités de l'API IMAP dans leurs applications. Avec des fonctionnalités telles que la synchronisation en temps réel, l'authentification sécurisée et la gestion des dossiers, elle élimine les complexités des protocoles IMAP bruts tout en garantissant une configuration rapide.

Essai gratuit
Lire la documentation

FAQ

Questions fréquemment posées

Tout ce que vous devez savoir sur l'intégration d'IMAP avec l'API d'Unipile

L'API unifiée d'email d'Unipile couvre trois voies d'intégration : Gmail (via l'API Gmail et OAuth), Outlook par Microsoft Graph et OAuth – couvre Outlook personnel, Microsoft 365 et Exchange Online), et IMAP comme solution de repli universelle pour tous les autres fournisseurs.

Les fournisseurs compatibles IMAP incluent : Yahoo Mail, AOL Mail, GMX, FastMail, Zoho Mail, Mail.com, ProtonMail (via Bridge), et tout domaine personnalisé exécutant un serveur IMAP conforme aux normes.

Oui. Les identifiants IMAP sont chiffrés au repos à l'aide d'un chiffrement standard de l'industrie. Le flux d'authentification hébergé par Unipile signifie que votre application ne gère jamais les mots de passe bruts : les utilisateurs saisissent leurs identifiants sur une page sécurisée hébergée par Unipile, et votre application ne reçoit qu'un account_id.

Toutes les connexions utilisent TLS en transit. Pour Gmail et Outlook, OAuth 2.0 est utilisé à la place des mots de passe.

Oui - c'est la valeur fondamentale d'Unipile. Une fois qu'un compte est connecté, toutes les opérations ultérieures utilisent les mêmes points d'accès : GET /api/v1/emails, POST /api/v1/emails, GET /api/v1/comptes/{id}/dossiers.

Vous écrivez l'intégration une fois, puis vous passez différentes account_id valeurs pour chaque fournisseur.

Oui. L'envoi est géré (voir envoyer un e-mail au nom de l'utilisateur API) via un seul POST /api/v1/emails Unipile achemine le message via le bon transport pour chaque fournisseur : SMTP pour les comptes IMAP, l'API Gmail pour Gmail, et Microsoft Graph pour Outlook.

La mise en fil des réponses, Cc/Cci, ainsi que les pièces jointes sont tous pris en charge.

Unipile maintient des connexions IMAP persistantes en votre nom, y compris la surveillance IDLE pour la détection de nouveaux e-mails en temps réel. La mise en commun des connexions, la reconnexion en cas de déconnexion et la gestion des limites de débit par fournisseur sont gérées de manière transparente.

Votre application effectue des appels HTTP sans état ; Unipile absorbe toute la complexité du protocole IMAP.

API Gmail (voir nos Guide de l'API Gmail) est une API REST propriétaire de Google qui ne fonctionne qu'avec les comptes Gmail. IMAP est le protocole à norme ouverte qui fonctionne avec tout serveur de messagerie conforme aux normes, mais l'IMAP brut nécessite une programmation de socket et n'a pas d'API HTTP native.

Unipile comble le fossé : il expose à la fois Gmail et IMAP via les mêmes points de terminaison REST, vous offrant ainsi la fiabilité de Gmail pour les comptes Google et une couverture IMAP universelle pour tous les autres, avec une seule intégration.

Inscrivez-vous gratuitement sur tableau de bord.unipile.com - aucune carte de crédit requise. Vous bénéficiez d'un accès complet à l'API pour connecter des comptes et tester tous les points de terminaison d'e-mail.

Les plans payants évoluent en fonction du nombre de comptes liés. Voir le page de tarifs. pour plus de détails, ou parlez à l'équipe pour discuter des prix de gros.

Vous avez encore des questions ? Parlez à un expert – nous répondons généralement en quelques minutes

fr_FRFR