Création d'un sous compte
Cette requête est utilisée pour créer un sous-compte.
URL
POST https://api.mailpartner.fr/v1/subaccount/create
Paramètres obligatoires
apiKey
type
Type de sous-compte : ce choix est définitif, il ne sera plus possible de le modifier
simple: – Le sous compte ne recevra aucun email ni SMS. – Aucun numéros de téléphone demandé. – L’achat n’est pas permis.
advanced : – Un email valide est demandé. – Le processus d’inscription est identique à celui d’un compte standard. – Un numéro de téléphone mobile sera demandé à l’inscription.
parameters
email(optionnel) : Si ce champ est vide, un email sera généré automatiquement (ex: [email protected])creditToAttribute(optionnel) : Crédits en euro ajouté au sous-compte lors de la création. Ce crédit sera déduit du solde de votre compte principal.title(optionnel) : Nom du sous-comptefirstname(optionnel) : Prénom du titulaire du sous-comptelastname(optionnel) : Nom du titulaire du sous-compte
email: Email valide du titulaire du compteisBuyer:1ou0, si isBuyer=1 alors le sous-compte pour acheter ses propres SMScreditToAttribute(optionnel) : Crédits en euro ajouté au sous-compte lors de la création. Ce crédit sera déduit du solde de votre compte principal.title(optionnel) : Nom du sous-comptefirstname(optionnel) : Prénom du titulaire du sous-comptelastname(optionnel) : Nom du titulaire du sous-compte
Requêtes
<?php
// Prepare data for POST request
$fields = array(
'apiKey'=> 'YOUR API KEY',
'type'=> 'advanced',
'parameters'=>array(
'email':'[email protected]',
'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;
?>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":"[email protected]","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# 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":"[email protected]","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 statuscurl -H "Content-Type: application/json" -X POST -d '{"apiKey":"xxxxx","type":"advanced","parameters":{"email":"[email protected]","creditToAttribute":10,"isBuyer":0,"firstname":"prenom","lastname":"nom"}}' https://api.mailpartner.fr/v1/subaccount/createRéponse
{
"success":true,
"code":200,
"subaccount":
{
"email":"[email protected]",
"token":"token"
},
"sendConfirmMailTo":"[email protected]",
"parent_email":"[email protected]"
}<?xml version="1.0" encoding="UTF-8"?>
<result>
<entry>true</entry>
<entry>200</entry>
<entry>
<entry><![CDATA[[email protected]]]></entry>
<entry><![CDATA[token]]></entry>
</entry>
<entry><![CDATA[[email protected]]]></entry>
<entry><![CDATA[[email protected]]]></entry>
</result>Erreurs
{
"success": false,
"code": 10,
"message": "Clé API incorrecte"
}<?xml version="1.0" encoding="UTF-8"?>
<result>
<entry>false</entry>
<entry>10</entry>
<entry>
<![CDATA[Clé API incorrecte]]>
</entry>
</result>Code erreurs
1
La Clé API est requise
2
Le numéro de téléphone est requis
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érieure à 0
9
La balance doit être supérieure à 0
200
Tout s'est bien passé !
Mis à jour