Ciblage & calcule
- Home
- Ciblage & calcule
Ciblage et calcul
Cette requête permet de calculer le ciblage,et le coût du ciblage.
URL
POST https://api.smspartner.fr/v1/location/optin
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 SMS Partner. |
---|---|
op |
Opération à effectuer:
|
parameters |
sexe:
Sexe des contacts ciblés, doit-être: minAge: Age minimum de la cible, doit-être supérieur à 18. maxAge: Age maximum de la cible, doit-être inférieur à 99. interest: Centre d’intérêt principal de la cible. subInterest (optionnel): Sous catégorie du centre d’intérêt. category (optionnel):
Catégorie sociaux-professionnelle: department (optionnel): Liste des départements ciblés. ex: 02,60, etc… zipcode (optionnel): Liste des codes postaux ciblés. ex: 02200,60200, etc… |
volumes |
Ce paramètre est disponible uniquement si op = rent ou price. Permet de choisir un volume souhaité par code postal ou département |
_format | Format 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 28 29 30 31 |
<?php // Prepare data for POST request $fields = array( 'apiKey'=> 'YOUR API KEY', 'op':'calcul', 'parameters':{ 'sexe'=> 'm', 'minAge'=> '25', 'maxAge' => '35', 'zipcode'=> '60200', 'interest'=> 14, /*Habitation*/ 'subInterest'=> 35 /*Cuisine*/ }, 'volumes':{ '60200':20 } ); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/location/optin'); 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 60 61 62 |
Imports System.IO Imports System.Net Module Module1 Sub Main() Dim base_url As String = "http://api.smspartner.fr/v1/" Dim apiKey As String = "YOUR API KEY" #send sms url = base_url & "location/optin" #note : utiliser une librairie JSON en production, par exemple : #https//www.nuget.org/packages/Newtonsoft.Json/ Dim parameters As String = String.Format( "{{""apiKey"":""{0}"",""op"":""{1}"",""parameters"":""{2}"",""volumes"":""{3}""}}", apiKey, "price", "{ "sexe"=> "m","minAge"=> "25","maxAge" => "35","zipcode"=> "60200","interest"=> 14,"subInterest"=> 35}", "{"60200":20}" ) "" 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 |
# std import http.client conn = http.client.HTTPConnection("api,smspartner,fr") payload = "{"apiKey":"YOUR API KEY","op":"price","parameters":{"sexe":"f","minAge":25,"maxAge":35,"zipcode":"06200","interest":12,"subInterest":29,"category":103},"volumes":{"60200":20}}" headers = { "Content-Type": "application/json" } conn.request("POST", "v1,location,optin", payload, headers) res = conn.getresponse() data = res.read() print(data.decode("utf-8")) |
1 |
curl -X POST https://api.smspartner.fr/v1/location/optin -H "Content-Type: application/json" -d '{"apiKey":"YOUR API KEY","op":"price","parameters":{"sexe":"f","minAge":25,"maxAge":35,"zipcode":"06200","interest":"12","subInterest":"29","category":103}} |
Réponses
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
{ "success": true, "op": "price", "datas": [ { "Type": "CP", "Localite": "06200", "Volume": 20 }, { "Type": "total", "Localite": "total", "Volume": 20 } ], "cost": { "quantity": 20, "total": 2.52, "cost_unity": 0.09 } } |
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 |
<?xml version="1.0" encoding="UTF-8"?> <result> <entry>true</entry> <entry> <![CDATA[price]]> </entry> <entry> <entry> <entry> <![CDATA[CP]]> </entry> <entry> <![CDATA[06200]]> </entry> <entry>28</entry> </entry> <entry> <entry> <![CDATA[total]]> </entry> <entry> <![CDATA[total]]> </entry> <entry>28</entry> </entry> </entry> <entry> <entry>28</entry> <entry>2.52</entry> <entry>0.09</entry> </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 |
<?xml version='1.0' encoding='UTF-8'?> <result> <entry>false</entry> <entry>10</entry> <entry>Clé API incorrecte</entry> </result> |
Code de contrôle
Réponse | ||
---|---|---|
1 | La Clé API est requise | |
10 | Clé API incorrecte | |
200 | Tout s’est bien passé ! |