Création de sous-compte mail
- Home
- Création de sous-compte mail
Création de sous-compte
Création de sous-compte.
URL
POST https://api.mailpartner.fr/v1/subaccount/create
Paramètres
Chaque demande d’API prend en charge les paramètres suivants :
apiKey | Clé API de votre compte. Vous l’obtenez dans votre compte Mail Partner. |
---|---|
type | Type de sous-compte : ce choix est définitif, il ne sera plus possible de le modifier
|
parameters |
email : Email valide du titulaire du compte isBuyer : Si creditToAttribute (optionnel) : Crédit en euros ajouté au sous-compte lors de la création. Ce crédit sera déduit du compte principal. title (optionnel): Nom du sous-compte. firstname (optionnel) : Prénom du titulaire du sous-compte. lastname (optionnel) : Nom du titulaire du sous-compte. email (optionnel) : Si ce champ est vide, un email sera généré automatiquement (ex: 9875587@mailpartner.fr) creditToAttribute (optionnel) : Crédit en euros ajouté au sous-compte lors de la création. Ce crédit sera déduit du compte principal. title (optionnel): Nom du sous-compte. firstname (optionnel) : Prénom du titulaire du sous-compte. lastname (optionnel) : Nom du titulaire du sous-compte. |
Paramètres optionnels_formatFormat de la réponse. Vous pouvez choisir entre JSON
ou XML
. Par défaut, le format de réponse est JSON
.
Requête
Exemple de requête :
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 |
<?php // Prepare data for POST request $fields = array( 'apiKey'=> 'YOUR API KEY', 'type'=> 'advanced', 'parameters'=>array( 'email':'aaaa@bbb.ccc', 'creditToAttribute':10, 'isBuyer':0, 'firstname':'prenom', 'lastname':'nom' )); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL,'https://api.mailpartner.fr/v1/subaccount/create'); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); curl_setopt($curl, CURLOPT_TIMEOUT, 10); curl_setopt($curl, CURLOPT_POST, 1); curl_setopt($curl, CURLOPT_POSTFIELDS,json_encode($fields)); $result = curl_exec($curl); curl_close($curl); // Process your response here echo $result; ?> |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 |
Imports System.IO Imports System.Net Module Module1 Sub Main() Dim base_url As String = "http://api.mailpartner.fr/v1/" Dim apiKey As String = "VOTRE_APIKEY" #send sms url = base_url & "subaccount/create" #note : utiliser une librairie JSON en production, par exemple : #https//www.nuget.org/packages/Newtonsoft.Json/ Dim parameters As String = String.Format( "{{""apiKey"":""{0}"",""type"":""{1}"",""parameters"":""{2}""}}", apiKey, "advanced", {"email":"aaaa@bbb.ccc","creditToAttribute":10,"isBuyer":0,"firstname":"prenom","lastname":"nom"}) Console.Write(parameters) apiRequest("POST", url, parameters) End Sub Function apiRequest(method As String, url As String, parameters As String) As String Dim request As HttpWebRequest request = WebRequest.Create(url) request.Method = method request.Timeout = 10000 # timeout in ms request.ContentType = "application/json; charset=utf-8" request.ContentLength = 0 #set POST data If Not String.IsNullOrEmpty(parameters) Then request.ContentLength = parameters.Length Using reqStream As StreamWriter = New StreamWriter(request.GetRequestStream()) reqStream.Write(parameters) End Using End If #get response Dim returnValue As String = Nothing Using response As HttpWebResponse = request.GetResponse() If response.StatusCode = HttpStatusCode.OK Then Using resStream = response.GetResponseStream() If resStream IsNot Nothing Then Using reader As New StreamReader(resStream) returnValue = reader.ReadToEnd() End Using End If End Using End If End Using apiRequest = returnValue End Function End Module |
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 |
# std import logging import json from collections import OrderedDict # 3p import requests API_KEY = "MY API KEY" URL = "https://api.mailpartner.fr/v1" class MailPartner(): def create(self,creditToAdd,userId): data = {"apiKey":APIKEY,"type":"advanced","parameters": {"email":"aaaa@bbb.ccc","creditToAttribute":10,"isBuyer":0,"firstname":"prenom","lastname":"nom"}} url = URL + "/subaccount/create" r = requests.post(url, data=json.dumps(data), verify=False) r_json = r.json() if r_json.get("success") == True: print(r_json) status = True else: print(r_json) status = False return status |
1 |
curl -H "Content-Type: application/json" -X POST -d '{"apiKey":"xxxxx","type":"advanced","parameters":{"email":"aaaa@bbb.ccc","creditToAttribute":10,"isBuyer":0,"firstname":"prenom","lastname":"nom"}}' https://api.mailpartner.fr/v1/subaccount/create |
Réponses
1 2 3 4 5 6 7 8 9 10 11 |
{ "success":true, "code":200, "subaccount": { "email":"aaaa@bbb.ccc", "token":"token" }, "sendConfirmMailTo":"aaaa@bbb.ccc", "parent_email":"emailparent@ddd.eee" } |
1 2 3 4 5 6 7 8 9 10 11 |
<?xml version="1.0" encoding="UTF-8"?> <result> <entry>true</entry> <entry>200</entry> <entry> <entry><![CDATA[aaaa@bbb.ccc]]></entry> <entry><![CDATA[token]]></entry> </entry> <entry><![CDATA[aaaa@bbb.ccc]]></entry> <entry><![CDATA[emailparent@ddd.eee]]></entry> </result> |
Erreurs
Exemple de message d’erreur :
1 2 3 4 5 |
{ "success": false, "code": 10, "message": "Clé API incorrecte" } |
1 2 3 4 5 6 7 8 |
<?xml version="1.0" encoding="UTF-8"?> <result> <entry>false</entry> <entry>10</entry> <entry> <![CDATA[Clé API incorrecte]]> </entry> </result> |
Code de contrôle
Réponse | ||
---|---|---|
1 | La Clé API est requise | |
2 | Vous n’avez pas l’authorisation | |
3 | isBuyer est requis | |
4 | Le type est requis (simple ou advanced) | |
5 | Le type de sous-compte n’existe pas (simple ou advanced) | |
6 | L’email est requis | |
7 | Un compte existe déjà avec cet email | |
8 | creditToAttribute doit être supérieurr à 0 | |
9 | La balance doit être supérieur à 0 | |
200 | Tout s’est bien passé ! |