Snapshoot
API · Webservices · Webhooks · Suisse

API Email : Connectez vos applications à une infrastructure d’envoi industrielle.

REST, SOAP, webhooks et FTP : tous les standards pour intégrer email et SMS dans vos applications, automatiser vos flux et garder la main sur vos scénarios d’envoi. Documentation claire, environnements de test, support technique inclus dans toutes les offres.

API REST EFIREST v2.2 Webservice SOAP v3 Webhooks événementiels
Lire la documentation Obtenir un token API
Une API conçue pour les équipes techniques

Solide, observable, prête à industrialiser vos flux.

Documentation détaillée, exemples de code concrets, sandbox d’intégration et support technique inclus. L’environnement est pensé pour des intégrations qui durent et qui supportent la montée en charge.

0,00%
Disponibilité 2024Infrastructure redondée, supervision 24/7, statut public en temps réel.
<50 ms
Latence d’envoiP95 sous 50 ms en Europe pour les requêtes API transactionnelles.
2 h
Délai de supportDemandes d’assistance traitées en moins de 2 heures sur les cas opérationnels.
6
Connecteurs disponiblesREST, SOAP, Webhooks, SMTP, FTP/SFTP, SMTP-to-SMS — un protocole pour chaque stack.
Capacités de l’API

Tout ce qu’il faut pour intégrer email et SMS dans votre application.

Authentification standard, payloads JSON ou XML, chiffrement TLS, idempotence des requêtes, rate-limit lisible, codes d’erreur explicites. La couverture fonctionnelle s’étend de l’envoi unitaire aux campagnes de masse.

Envoi transactionnel

Email ou SMS unitaire, déclenchés par votre application : confirmation, OTP, notifications, reset de mot de passe. Latence maîtrisée, idempotence supportée.

Envoi en masse

Campagnes batch, déclenchement par lot, throttling configurable, gestion des opt-in et désabonnements automatique. Conçu pour absorber les pics.

Webhooks événementiels

Notifications HTTP en temps réel : delivered, opened, clicked, bounced, complained, unsubscribed. Signature HMAC, retries configurables.

Pièces jointes personnalisées

Joignez des PDF, factures, contrats ou tickets nominatifs à chaque envoi. Idéal pour les emails transactionnels riches.

Suivi unitaire

Statut détaillé pour chaque message : queued, sent, delivered, opened, clicked, bounced. Recherche, export, statistiques par connecteur.

Sécurité de bout en bout

TLS 1.2+, tokens scopés, 2FA disponible, datacenters certifiés ISO/IEC 27001 et PCI-DSS. Conformité nLPD et RGPD.

API REST · EFIREST v2.2

Une API REST simple, robuste et richement documentée.

Endpoints lisibles, payloads JSON, codes HTTP standards, authentification Bearer token. Adoptez l’API REST pour des intégrations modernes côté backend ou côté serverless. La documentation complète est téléchargeable et le support à l’intégration est inclus.

  • Authentification BearerTokens scopés, rotation à tout moment depuis le dashboard.
  • Idempotence supportéeHeader Idempotency-Key pour éviter les doublons en cas de retry.
  • Codes d’erreur explicitesRéponses JSON avec error.code et error.message pour debug rapide.
Node.js JS 
const res = await fetch("https://api.snapshoot.ch/v2/email/send", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${SNAPSHOOT_API_KEY}`,
    "Content-Type": "application/json",
    "Idempotency-Key": "msg_8a7b2c"
  },
  body: JSON.stringify({
    from:    "hello@snapshoot.ch",
    to:      "marie@exemple.ch",
    subject: "Confirmation",
    html:    "<h1>Bienvenue</h1>"
  })
});

const data = await res.json();
// => { id: "msg_8a7b2c", status: "queued" }
Webhook payload JSON 
{
  "event":      "email.delivered",
  "timestamp":  "2026-05-04T09:41:23Z",
  "message_id": "msg_8a7b2c",
  "recipient":  "marie@exemple.ch",
  "metadata": {
    "campaign":    "welcome_series",
    "order_id":    "4827"
  },
  "signature":  "sha256=a7b2c8f..."
}
Webhooks événementiels

Soyez notifié en temps réel des événements de vos messages.

Recevez une requête HTTP POST sur votre endpoint dès qu’un événement survient. Signature HMAC SHA-256, retries automatiques, métadonnées personnalisables : intégrez les statuts d’envoi dans votre CRM, votre datalake ou votre système de monitoring.

  • 10 événements couvertsqueued, sent, delivered, opened, clicked, bounced, complained, unsubscribed, failed, deferred.
  • Signature HMAC SHA-256Vérifiez l’authenticité de chaque webhook reçu côté serveur.
  • Retries exponentielsTentatives automatiques en cas d’échec, jusqu’à 24h de durabilité.
Cas d’usage

Quatre intégrations typiques que l’API couvre nativement.

E-commerce

Confirmation de commande

Déclenchez l’envoi d’un email de confirmation depuis votre back-office, avec PDF de facture en pièce jointe et webhook de suivi de livraison vers votre OMS.

POST /v2/email/sendWebhooksPJ dynamiques
SaaS · Auth

Reset de mot de passe

Email transactionnel déclenché par votre application avec lien tokenisé. Latence sous 50 ms pour ne jamais frustrer l’utilisateur en attente.

API RESTLatence faibleIdempotence
Industrie · Batch

Bulletin de paie mensuel

Envoi en masse mensuel de bulletins PDF nominatifs via SOAP ou FTP. Throttling, suivi par lot, traçabilité complète à l’unité.

SOAPFTP/SFTPPJ par destinataire
CRM · Marketing

Synchro CRM ↔ Snapshoot

Webhooks de delivered/opened/clicked envoyés vers votre CRM pour enrichir le profil de chaque contact et déclencher des automatisations.

WebhooksMétadonnéesTemps réel
Comment intégrer

De zéro à la production en quatre étapes maîtrisées.

Création de compte, génération du token, tests sandbox puis bascule en production : un parcours d’intégration clair, accompagné par le support technique.

  1. 01
    → signup

    Créer un compte

    Inscription gratuite, validation email, accès au dashboard immédiat. 60 jours de test offerts.

  2. 02
    → token

    Générer un token

    Token API en un clic. Scopes par environnement, rotation possible à tout moment.

  3. 03
    → test

    Tester en sandbox

    Environnement isolé, payloads de référence, codes de retour documentés, support inclus.

  4. 04
    → deploy

    Passer en production

    Bascule contrôlée, monitoring des statuts, webhooks d’événements actifs.

Documentation à télécharger

Toutes les références d’API, à jour, dans des PDF maintenus.

REST

Webservice REST

EFIREST API v2.2 — référence complète des endpoints, formats de payloads et codes de retour HTTP.

PDF · v2.2↓
SOAP

Webservice SOAP

SOAP Multicanal v3 — XML payloads, WSDL, méthodes pour environnements legacy ou industriels.

PDF · v3↓
HOOK

Webhooks

Référence des événements asynchrones : delivered, opened, clicked, bounced, complained, etc.

PDF · 2025↓
FTP·E

API Email FTP

Dépôt batch de campagnes par FTP/SFTP — formats, conventions de nommage, traitement.

PDF↓
FTP·S

SMS via FTP/SFTP

Envois SMS en lot par FTP/SFTP, idéal pour les architectures industrielles ou batch.

PDF↓
ALL

Toute la documentation

Hub central regroupant les huit documentations techniques officielles, à télécharger librement.

Hub→
Continuer la visite

Découvrez les autres briques de l’univers développeurs.

Protocole · SMTP

Relais SMTP

Le protocole d’envoi le plus universel. Authentification SPF/DKIM/DMARC, TLS, suivi à l’envoi pour des usages applicatifs ou hybrides.

Explorer le relais SMTP SMS · OTP · MFA

SMS API & OTP

Notifications, MFA, OTP, messages transactionnels. Un canal SMS exploitable proprement, avec une logique claire pour les usages sensibles.

Voir SMS API & OTP
Questions fréquentes

Tout ce qu’il faut savoir avant d’intégrer l’API.

Quel format de payload utilise l’API ?

L’API REST utilise des payloads JSON pour les requêtes et les réponses. Pour les environnements legacy ou industriels, le webservice SOAP propose un format XML avec WSDL associé. Les deux protocoles couvrent les mêmes fonctionnalités d’envoi.

Comment éviter les doublons en cas de retry ?

L’API REST supporte le header Idempotency-Key : si vous renvoyez la même requête avec la même clé d’idempotence, l’API retournera le résultat de la première exécution sans envoyer de doublon. Pratique pour les retry réseau ou les jobs qui peuvent rejouer.

Y a-t-il un environnement de test (sandbox) ?

Oui. À la création de votre compte, vous bénéficiez d’un environnement de test isolé pour valider votre intégration sans impacter votre quota d’envois ni votre réputation d’expéditeur. Les payloads et codes de retour sont identiques à la production.

Quelle est la limite de débit (rate-limit) ?

Le rate-limit est dimensionné selon votre offre. Les headers HTTP X-RateLimit-Limit et X-RateLimit-Remaining renvoient l’état courant. Pour les architectures qui doivent absorber des pics, l’équipe technique peut adapter la configuration.

Comment vérifier l’authenticité d’un webhook ?

Chaque webhook est signé HMAC SHA-256 avec une clé secrète propre à votre compte. Le header X-Snapshoot-Signature contient la signature : recalculez-la côté serveur pour valider que le webhook provient bien de Snapshoot.

Prochaine étape

Commencez à intégrer l’API dès aujourd’hui.

Documentation complète, sandbox prêt à l’emploi, équipe technique joignable. Le support à l’intégration est inclus dans toutes les offres.

Démarrer gratuitement Voir la documentation