{"id":2692,"date":"2018-04-18T11:35:27","date_gmt":"2018-04-18T09:35:27","guid":{"rendered":"https:\/\/dev.serversmtp.com\/?page_id=2692"},"modified":"2018-04-18T11:36:23","modified_gmt":"2018-04-18T09:36:23","slug":"service-smtp-api","status":"publish","type":"page","link":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/","title":{"rendered":"SMTP web API"},"content":{"rendered":"<p><strong>L&#8217;API de turboSMTP<\/strong> est un excellent moyen de personnaliser notre service, en l&#8217;integrant o\u00f9 vous pr\u00e9f\u00e9rez.<\/p>\n<p>En g\u00e9n\u00e9ral, une API (Application Programming Interface) est un protocole qui d\u00e9finit une interface pour les composants d&#8217;un logiciel, afin qu&#8217;ils puissent communiquer les uns avec les autres.<\/p>\n<p>Pour le moment nous fournissons une m\u00e9thode <strong>Send<\/strong> qui vous permet de cr\u00e9er un script pour ex\u00e9cuter turboSMTP et envoyer des emails transactionnels (messages de confirmation, messages d&#8217;accueil, etc.) <strong>\u00e0 travers du web<\/strong>, sans l&#8217;aide du protocole SMTP.<\/p>\n<p>Donc, si vous avez <strong>un site ou une application<\/strong> et vous devez envoyer un message directement \u00e0 partir de l\u00e0, vous pouvez impl\u00e9menter cette m\u00e9thode dans votre script et de la g\u00e9rer facilement.<\/p>\n<p>Ci-dessous vous trouverez la documentation compl\u00e8te (en anglais). Nous sommes en train de <strong>d\u00e9velopper des nouvelles m\u00e9thodes<\/strong>: nous vous tiendrons au courant!<\/p>\n<h3>T\u00e9l\u00e9chargez le code source d&#8217;exemple<\/h3>\n<p><a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/turbo_send_email_code.zip\"><span>PHP<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/CSharp-turboSMTP-API.zip\"><span>C#<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Java-turboSMTP-API.zip\"><span>Java<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Python-turboSMTP-API.zip\"><span>Python<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Perl-turboSMTP-API.zip\"><span>Perl<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Ruby-turboSMTP-API.zip\"><span>Ruby<\/span><\/a><\/p>\n<p>&nbsp;<\/p>\n<hr>\n<p><span style=\"color: #005293; font-size: 1.5em; line-height: 1.3em;\">Send (Beta 1.0)<\/span><\/p>\n<p>Ce service vous permet d&#8217;envoyer un email.<\/p>\n<h3>Index<\/h3>\n<ul>\n<li class=\"index-item\" data-link=\"parameters\">Param\u00e8tres<\/li>\n<li class=\"index-item\" data-link=\"post-request\">POST request<\/li>\n<li class=\"index-item\" data-link=\"mime-message\">MIME body message<\/li>\n<li class=\"index-item\" data-link=\"curl-request\">Exemple d&#8217;envoi email (curl)<\/li>\n<li class=\"index-item\" data-link=\"send-script-example\">Exemple d&#8217;envoi email\ufeff (PHP)<\/li>\n<li class=\"index-item\" data-link=\"turbo-api-client\">TurboApiClient (PHP)<\/li>\n<li class=\"index-item\" data-link=\"download-source-code\">T\u00e9l\u00e9charger le code d&#8217;exemple (PHP)<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p><!-- PARAMETERS --><\/p>\n<h3 id=\"parameters\">Paramet\u00e8res<a class=\"top-link\" href=\"#\"> [top]<\/a><\/h3>\n<table class=\"table table-striped table-bordered\">\n<thead>\n<tr>\n<th>Param\u00e8tre<\/th>\n<th>Requis<\/th>\n<th>Obligations<\/th>\n<th>Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>to<\/td>\n<td>Oui<\/td>\n<td>Adresse email valide.<\/td>\n<td>Liste des destinataires. En cas de destinataires multiples, les adresses doivent \u00eatre s\u00e9par\u00e9es par une virgule.\ufeff<\/td>\n<\/tr>\n<tr>\n<td>subject<\/td>\n<td>Non<\/td>\n<td>Max 700 characters string.<\/td>\n<td>Le sujet de l&#8217;email \u00e0 envoyer.<\/td>\n<\/tr>\n<tr>\n<td>from<\/td>\n<td>Oui<\/td>\n<td><span>Adresse email valide.<\/span>\ufeff<\/td>\n<td>L&#8217;adresse exp\u00e9diteur de l&#8217;email \u00e0 envoyer.<\/td>\n<\/tr>\n<tr>\n<td>bcc<\/td>\n<td>Non<\/td>\n<td><span>Adresses email valide.<\/span>\ufeff<\/td>\n<td>Liste de copie carbone invisible. En cas de destinataires multiples, les adresses doivent \u00eatre s\u00e9par\u00e9es par une virgule.\ufeff<\/td>\n<\/tr>\n<tr>\n<td>cc<\/td>\n<td>Non<\/td>\n<td><span>Adresses email valide.<\/span>\ufeff<\/td>\n<td>Liste de copie carbone. En cas de destinataires multiples, les adresses doivent \u00eatre s\u00e9par\u00e9es par une virgule.\ufeff<\/td>\n<\/tr>\n<tr>\n<td>content<\/td>\n<td>Non<\/td>\n<td>&nbsp;<\/td>\n<td>Contenu textuel de l&#8217;email.<\/td>\n<\/tr>\n<tr>\n<td>html_content<\/td>\n<td>Non<\/td>\n<td>&nbsp;<\/td>\n<td>Contenu HTML de l&#8217;email.<\/td>\n<\/tr>\n<tr>\n<td>custom_headers<\/td>\n<td>Non<\/td>\n<td>Format JSON valide.<\/td>\n<td>Valeur de la remise des cl\u00e9s des header personnalis\u00e9s \u00e0 mettre dans le courriel. Exemple:\ufeff<\/p>\n<pre> {\"X-key1\":\"value1\", \"X-key2\":\"value2\"}<\/pre>\n<\/td>\n<\/tr>\n<tr>\n<td>mime_raw<\/td>\n<td>Non<\/td>\n<td>Format MIME standard.<\/td>\n<td>Message MIME, qui remplace content and html_content.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><!-- POST REQUEST --><\/p>\n<h3 id=\"post-request\">&nbsp;<\/h3>\n<h3>Post request<a class=\"top-link\" href=\"#\"> [top]<\/a><\/h3>\n<h4>Url<\/h4>\n<pre>https:\/\/api.turbo-smtp.com\/api\/mail\/send<\/pre>\n<p>L&#8217;authentification de l&#8217;utilisateur s&#8217;effectue avec les param\u00e8tres suivants:\ufeff<\/p>\n<ul>\n<li><strong>authuser<\/strong>: Nom de l&#8217;utilisateur<\/li>\n<li><strong>authpass<\/strong>: Mot de passe<\/li>\n<\/ul>\n<p>Les donn\u00e9es d&#8217;authentification peuvent etre ger\u00e9es comme param\u00e8tres GET et &nbsp;POST, ou comme header de https request&#8217;s.<\/p>\n<h4>Exemple de Post request<\/h4>\n<pre>from:from_address@domain.com\r\nto:to1_address@domain.com,to2_address@domain.com\r\ncc:cc1_address@domain.com,cc2_address@domain.com\r\nbcc:bcc1_address@domain.com,bcc2_address@domain.com\r\nsubject:subject of email\r\ncontent:text content of email\r\nhtml_content: html content of email\r\ncustom_headers:{\"X-key1\":\"value1\", \"X-key2\":\"value2\"}\r\n \t\t\t\t<\/pre>\n<p><!-- POST RESPONSE --><\/p>\n<h4 id=\"post-response\">R\u00e9ponses<\/h4>\n<p>Les r\u00e9ponses du serveur sont en format JSON. Les membres de l&#8217;objet sont:\ufeff<\/p>\n<ul>\n<li><strong>message<\/strong>: &#8220;OK&#8221; en cas de success, &#8220;error&#8221; en cas d&#8217;erreur<\/li>\n<li><strong>errors<\/strong>: (seulement en cas d&#8217;erreur) tableau contenant les messages d&#8217;erreur\ufeff<\/li>\n<\/ul>\n<p>&nbsp;<\/p>\n<p><!-- SUCCESS RESPONSE --><\/p>\n<h4 id=\"success-response\">R\u00e9ponse de success<\/h4>\n<pre> { \"message\":\"OK\" }<\/pre>\n<p><!-- ERROR RESPONSE --><\/p>\n<h4 id=\"error-response\">R\u00e9ponse d&#8217;erreur<\/h4>\n<pre> { \"message\": \"error\",\"errors\": [\"error message\",...]} <\/pre>\n<h4>Exemple d&#8217;une r\u00e9ponse d&#8217;erreur<\/h4>\n<pre> { \"message\": \"error\",\"errors\": [\"'broken@@@Address.@@' recipient email not valid\" , \"'broken2@@@Address2.@@222' bcc email not valid\"]} <\/pre>\n<p><!-- MIME MESSAGE --><\/p>\n<h3 id=\"mime-message\">&nbsp;<\/h3>\n<h3>MIME type body message<a class=\"top-link\" href=\"#\"> [top]<\/a><\/h3>\n<p>Dans le cas o\u00f9 vous voulez envoyer que le corps de l&#8217;e-mail, un message de type MIME, vous devez l&#8217;envoyer comme un param\u00e8tre POST nomm\u00e9 &#8220;mime&#8221;.<\/p>\n<p>Dans ce cas, les param\u00e8tres de contenu et content_html sont ignor\u00e9s. Le message doit \u00eatre standard. Si vous envoyez un message sans t\u00eate dont vous avez besoin en tout cas, tel que requis par la sp\u00e9cification, de laisser une ligne vide avant le corps.<\/p>\n<p>Ce param\u00e8tre permet d&#8217;envoyer un fichier \u00e0 l&#8217;int\u00e9rieur du message.\ufeff<\/p>\n<p><!-- CURL EXAMPLE --><\/p>\n<h3 id=\"curl-request\">&nbsp;<\/h3>\n<h3>Exemple d&#8217;envoi email (curl) <a class=\"top-link\" href=\"#\">[top]<\/a><\/h3>\n<p>Exemple de code pour envoyer un email en utilisant le commande curl.\ufeff<\/p>\n<h4>Envoi de l&#8217;email<\/h4>\n<p>Envoyons un email en utilisant la cl\u00e9 d&#8217;authentification obtenue de l&#8217;appel pr\u00e9cedent.<\/p>\n<pre>curl --Header \"authuser:_username\" --Header \"authpass:_password\" --data \"to=john.smith@domain.com&amp;subject=email subject string&amp;from=john.smith@domain.com&amp;bcc=mark.davies@domain.com&amp;cc=mary.davies@domain.com&amp;content=content email&amp;html_content=html content of email\" https:\/\/api.turbo-smtp.com\/api\/mail\/send<\/pre>\n<p><!-- SEND SCRIPT EXAMPLE --><\/p>\n<h3 id=\"send-script-example\">&nbsp;<\/h3>\n<h3>Exemple d&#8217;envoi email (PHP) <a class=\"top-link\" href=\"#\">[top]<\/a><\/h3>\n<p>Un code PHP d&#8217;exemple pour envoyer un email avec notre API.<\/p>\n<h5>Code source<\/h5>\n<pre>require_once \"TurboApiClient.php\";\r\n\r\n\/\/ creation of the email to be sent\r\n$email = new Email();\r\n$email-&gt;setFrom(\"john.smith@domain.com\");\r\n$email-&gt;setToList(\"mark.davies@domain.com, bruce.campbell@domain.com\");\r\n$email-&gt;setCcList(\"mary.davies@domain.com, mary.smith@domain.com\");\r\n$email-&gt;setBccList(\"maria.campbell@domain.com, don.smith@domain.com\");\t\r\n$email-&gt;setSubject(\"subject\");\r\n$email-&gt;setContent(\"content\");\r\n$email-&gt;setHtmlContent(\"html content\");\r\n$email-&gt;addCustomHeader('X-FirstHeader', \"value\");\r\n$email-&gt;addCustomHeader('X-SecondHeader', \"value\");\r\n$email-&gt;addCustomHeader('X-Header-to-be-removed', 'value');\r\n$email-&gt;removeCustomHeader('X-Header-to-be-removed);\r\n\r\n\/\/ creation of a client that connects with turbo-smtp APIs\r\n$turboApiClient = new TurboApiClient(\"_username\", \"_password\");\r\n\r\n\/\/ email sending\r\n$response = $turboApiClient-&gt;sendEmail($email);\r\n\r\n\/\/ display of the operation's outcome\r\nvar_dump($response);\t\t\t\t\t\t\r\n\t\t\t\t<\/pre>\n<p><!-- TURBO API CLIENT --><\/p>\n<h3 id=\"turbo-api-client\">&nbsp;<\/h3>\n<h3>TurboApiClient (PHP)<a class=\"top-link\" href=\"#\"> [top]<\/a><\/h3>\n<p>Un simple client util \u00e0 se connecter avec notre API.<\/p>\n<h5>Code source<\/h5>\n<pre>require_once  \"TurboClient.php\";\r\nrequire_once  \"Email.php\";\r\n\r\nclass TurboApiClient{\r\n\t\r\n\tprotected $username;\r\n\tprotected $password;\r\n\tprivate $serverUrl = \"https:\/\/api.turbo-smtp.com\/api\";\r\n\r\n\tpublic function __construct($username, $password) {\r\n       $this-&gt;username = $username;\r\n\t   $this-&gt;password = $password;\r\n   }\r\n\r\n\tprotected function authorize(){\r\n\t\ttry {\r\n\t\t\t$api = new TurboClient($this-&gt;serverUrl, $this-&gt;username, $this-&gt;password);\r\n\t\t\treturn $api;\r\n\t\t} catch (Pest_Forbidden $ex) {\r\n\t\t    return null;\r\n\t\t}\r\n\t}\r\n\r\n\tpublic function sendEmail($email){\r\n\t\t$api = $this-&gt;authorize();\r\n\t\tif($api){\r\n\t\t\ttry {\r\n\t\t\t    \t$response = $api-&gt;post(\r\n\t\t\t    \t\t'\/mail\/send',\r\n\t\t\t       \t\t$email-&gt;getPostParameters()\r\n\t\t\t    \t);\r\n\t\t\t    return $response;\r\n\t\t\t} catch (Pest_NotFound $e) {\r\n\t\t\t    return $e;\r\n\t\t\t}\r\n\t\t}else{\r\n\t\t\treturn \"Authorization error\";\r\n\t\t}\r\n\t}\r\n};\r\n\t\t\t\t<\/pre>\n<p><!-- SOURCE CODE --><\/p>\n<h3 id=\"download-source-code\">&nbsp;<\/h3>\n<h3>T\u00e9l\u00e9charger le code source d&#8217;exemple<a class=\"top-link\" href=\"#\"> [top]<\/a><\/h3>\n<p><a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/turbo_send_email_code.zip\"><span>PHP<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/CSharp-turboSMTP-API.zip\"><span>C#<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Java-turboSMTP-API.zip\"><span>Java<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Python-turboSMTP-API.zip\"><span>Python<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Perl-turboSMTP-API.zip\"><span>Perl<\/span><\/a> <a class=\"cssbutton blue medium\" href=\"https:\/\/dashboard.serversmtp.com\/downloads\/Ruby-turboSMTP-API.zip\"><span>Ruby<\/span><\/a><\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>L&#8217;API de turboSMTP est un excellent moyen de personnaliser notre service, en l&#8217;integrant o\u00f9 vous pr\u00e9f\u00e9rez. En g\u00e9n\u00e9ral, une API (Application Programming Interface) est un protocole qui d\u00e9finit une interface pour les composants d&#8217;un logiciel, afin qu&#8217;ils puissent communiquer les uns avec les autres. Pour le moment nous fournissons une m\u00e9thode Send qui vous permet &#8230; <\/p>\n<p class=\"read-more-container\"><a title=\"SMTP web API\" class=\"read-more button\" href=\"https:\/\/serversmtp.com\/fr\/service-smtp-api\/#more-2692\" aria-label=\"En savoir plus sur SMTP web API\">Discover more<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_eb_attr":"","inline_featured_image":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"class_list":["post-2692","page","type-page","status-publish"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v25.3.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>SMTP web API - smtp mail server - professional SMTP service provider<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/serversmtp.com\/fr\/service-smtp-api\/\" \/>\n<meta name=\"twitter:label1\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data1\" content=\"5 minutes\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SMTP web API - smtp mail server - professional SMTP service provider","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/","twitter_misc":{"Dur\u00e9e de lecture estim\u00e9e":"5 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/","url":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/","name":"SMTP web API - smtp mail server - professional SMTP service provider","isPartOf":{"@id":"https:\/\/serversmtp.com\/#website"},"datePublished":"2018-04-18T09:35:27+00:00","dateModified":"2018-04-18T09:36:23+00:00","breadcrumb":{"@id":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/serversmtp.com\/fr\/service-smtp-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/serversmtp.com\/fr\/service-smtp-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/serversmtp.com\/fr\/"},{"@type":"ListItem","position":2,"name":"SMTP web API"}]},{"@type":"WebSite","@id":"https:\/\/serversmtp.com\/#website","url":"https:\/\/serversmtp.com\/","name":"smtp mail server - professional SMTP service provider","description":"smtp mail server - professional SMTP service provider","publisher":{"@id":"https:\/\/serversmtp.com\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/serversmtp.com\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Organization","@id":"https:\/\/serversmtp.com\/#organization","name":"Delivery Tech","url":"https:\/\/serversmtp.com\/","logo":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/serversmtp.com\/#\/schema\/logo\/image\/","url":"https:\/\/serversmtp.com\/wp-content\/uploads\/2021\/11\/og-image-2.jpg","contentUrl":"https:\/\/serversmtp.com\/wp-content\/uploads\/2021\/11\/og-image-2.jpg","width":1200,"height":1128,"caption":"Delivery Tech"},"image":{"@id":"https:\/\/serversmtp.com\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/pages\/2692"}],"collection":[{"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/comments?post=2692"}],"version-history":[{"count":2,"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/pages\/2692\/revisions"}],"predecessor-version":[{"id":2694,"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/pages\/2692\/revisions\/2694"}],"wp:attachment":[{"href":"https:\/\/serversmtp.com\/fr\/wp-json\/wp\/v2\/media?parent=2692"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}