Ajouter / retirer des crédits
- Home
- Ajouter / retirer des crédits
Adição de crédito
A partir da sua conta, você pode adicionar créditos às suas subcontas. Os recursos serão debitados de sua conta principal.
URLs
POST https://api.smspartner.fr/v1/subaccount/credit/add
Configurações
Cada solicitação de API suporta os seguintes parâmetros
| apiKey | Chave de API da sua conta. Você obtê-lo em sua conta SMS Partner |
|---|---|
| crédito | Número de crédito em euros adicionar subconta. |
| tokenSubaccount | Em Nome da conta. |
| Configurações opcionais | |
| _formato | Formato de resposta. Você pode escolher entre JSON ou XML. Por padrão, o formato de resposta é JSON. |
Petição
Consulta de exemplo :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
<?php // Prepare data for POST request $fields = array( 'apiKey'=> 'YOUR API KEY', 'credit'=> '100', 'tokenSubaccount'=>'identifiant du sous-compte' ); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/subaccount/credit/add'); 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.smspartner.fr/v1/" Dim apiKey As String = "VOTRE_APIKEY" #send sms url = base_url & "subaccount/credit/sms" #note : utiliser une librairie JSON en production, par exemple : #https//www.nuget.org/packages/Newtonsoft.Json/ Dim parameters As String = String.Format( "{{""apiKey"":""{0}"",""credit"":""{1}"",""tokenSubaccount"":""{2}""}}", apiKey, 50, "identifiant du sous-compte") 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 29 30 31 32 |
# std import logging import json from collections import OrderedDict # 3p import requests API_KEY = "MY API KEY" URL = "https://api.smspartner.fr/v1" class SMSPartner(): def add_credit(self,creditToAdd,tokenSubaccount): data = OrderedDict([ ("apiKey", API_KEY), ("credit",creditToAdd), ("tokenSubaccount",tokenSubaccount) ]) url = URL + "/subaccount/credit/add" 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","credit":"10","tokenSubaccount":"identifiant du sous-compte"}' https://api.smspartner.fr/v1/subaccount/credit/add |
Respostas
|
1 2 3 4 5 6 7 |
{ "success": true, "code": 200, "credit": 2869.2, "subaccountCredit": 61.8, "currency": "EUR" } |
|
1 2 3 4 5 6 7 8 9 10 |
<?xml version="1.0" encoding="UTF-8"?> <result> <entry>true</entry> <entry>200</entry> <entry>2859.2</entry> <entry>71.8</entry> <entry> <![CDATA[EUR]]> </entry> </result> |
Erros
Exemplo mensagem de erro :
|
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> |
Código de controle
| Resposta | ||
|---|---|---|
| 1 | A chave API é necessária | |
| 2 | Crédito é exigido | |
| 3 | O identificador de sub-conta é necessária | |
| 4 | Você não tem a permissão | |
| 5 | Crédito para atributo deve ser maior que 0 | |
| 6 | O saldo deve ser maior que 0 | |
| 7 | O sub-conta não existe | |
| 8 | Crédito insuficiente | |
| 10 | Chave de API inválida | |
| 200 | Tudo correu bem! | |
Remover crédito
De sua conta, você pode excluir suas contas de crédito abaixo. Os créditos serão adicionados à sua conta principal.
URLs
POST https://api.smspartner.fr/v1/subaccount/credit/remove
Configurações
Cada solicitação de API suporta os seguintes parâmetros :
| apiKey | Chave de API da sua conta. Você obtê-lo em sua conta SMS Partner |
|---|---|
| crédito | Número de crédito em euros adicionar subconta. |
| tokenSubaccount | Em Nome da conta. |
| Configurações opcionais | |
| _formato | Formato de resposta. Você pode escolher entre JSON ou XML. Por padrão, o formato de resposta é JSON. |
Petição
Consulta de exemplo :
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 |
<?php // Prepare data for POST request $fields = array( 'apiKey'=> 'YOUR API KEY', 'credit'=> '100', 'tokenSubaccount'=>'identifiant du sous-compte' ); $curl = curl_init(); curl_setopt($curl, CURLOPT_URL,'https://api.smspartner.fr/v1/subaccount/credit/add'); 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.smspartner.fr/v1/" Dim apiKey As String = "VOTRE_APIKEY" #send sms url = base_url & "subaccount/credit/sms" #note : utiliser une librairie JSON en production, par exemple : #https//www.nuget.org/packages/Newtonsoft.Json/ Dim parameters As String = String.Format( "{{""apiKey"":""{0}"",""credit"":""{1}"",""tokenSubaccount"":""{2}""}}", apiKey, 50, "identifiant du sous-compte") 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 29 30 31 32 |
# std import logging import json from collections import OrderedDict # 3p import requests API_KEY = "MY API KEY" URL = "https://api.smspartner.fr/v1" class SMSPartner(): def add_credit(self,creditToAdd,tokenSubaccount): data = OrderedDict([ ("apiKey", API_KEY), ("credit",creditToAdd), ("tokenSubaccount",tokenSubaccount) ]) url = URL + "/subaccount/credit/add" 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","credit":"10","tokenSubaccount":"identifiant du sous-compte"}' https://api.smspartner.fr/v1/subaccount/credit/add |
Respostas
|
1 2 3 4 5 6 7 |
{ "success": true, "code": 200, "credit": 2869.2, "subaccountCredit": 61.8, "currency": "EUR" } |
|
1 2 3 4 5 6 7 8 9 10 |
<?xml version="1.0" encoding="UTF-8"?> <result> <entry>true</entry> <entry>200</entry> <entry>2859.2</entry> <entry>71.8</entry> <entry> <![CDATA[EUR]]> </entry> </result |
Erros
Exemplo mensagem de erro :
|
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> |
Código de controle
| Resposta | ||
|---|---|---|
| 1 | A chave API é necessária | |
| 2 | Crédito é exigido | |
| 3 | O identificador de sub-conta é necessária | |
| 4 | Você não tem a permissão | |
| 5 | Crédito para atributo deve ser maior que 0 | |
| 6 | O saldo deve ser maior que 0 | |
| 7 | O sub-conta não existe | |
| 8 | Crédito insuficiente | |
| 10 | Chave de API inválida | |
| 200 | Tudo correu bem! | |