查詢餘額

GET

https://api.laaffic.com/v3/getBalance

當前接口用於獲取賬戶餘額

請求示例

Request URL:
    https://api.laaffic.com/v3/getBalance
Request Method:
    GET
Request Headers:
    Content-Type: application/json;charset=UTF-8
    Sign: 05d7a50893e22a5c4bb3216ae3396c7c
    Timestamp: 1630468800
    Api-Key: bDqJFiq9

響應參數

參數	説明	類型
status	狀態碼，0表示成功，其他參見狀態碼説明	String
reason	失敗原因説明	String
balance	賬戶的餘額	String
gift	贈送餘額	String
credit	信用額度	String

響應狀態碼

狀態碼	説明
0	成功
-1	認證錯誤
-2	IP訪問受限
-13	用戶被鎖
-16	超出時間限制
-18	接口異常

語言

Java

PHP

Curl

Python

請求

package com.laaffic.api.demo.sms;

import cn.hutool.core.util.StrUtil;
import cn.hutool.crypto.SecureUtil;
import cn.hutool.http.Header;
import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;
import cn.hutool.json.JSONUtil;

import java.net.URLEncoder;
import java.time.LocalDateTime;
import java.time.ZoneId;
import java.util.Arrays;
import java.util.HashMap;
import java.util.Map;

private void getBalance() {
    final String baseUrl = "https://api.laaffic.com/v3";
    final String apiKey = "your api key";
    final String apiPwd = "your api secret";

    final String url = baseUrl.concat("/getBalance");
    System.out.println(url);
    HttpRequest request = HttpRequest.get(url);
    // currentTime
    final String datetime = String.valueOf(LocalDateTime.now().atZone(ZoneId.systemDefault()).toInstant().getEpochSecond());
    // generate md5 key
    final String sign = SecureUtil.md5(apiKey.concat(apiPwd).concat(datetime));
    request.header(Header.CONNECTION, "Keep-Alive")
            .header(Header.CONTENT_TYPE, "application/json;charset=UTF-8")
            .header("Sign", sign)
            .header("Timestamp", datetime)
            .header("Api-Key", apiKey);
    HttpResponse response = request.execute();
    if (response.isOk()) {
        String result = response.body();
        System.out.println(result);
    }
}

請求

$apiKey = "your api key";
$apiSecret = "your api secret";
$url = "https://api.laaffic.com/v3/getBalance";
$timeStamp = time();
$sign = md5($apiKey.$apiSecret.$timeStamp);
$headers = array('Content-Type:application/json;charset=UTF-8',"Sign:$sign","Timestamp:$timeStamp","Api-Key:$apiKey");

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL,$url);
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 600);
curl_setopt($ch, CURLOPT_HTTPHEADER,$headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);

$output = curl_exec($ch);
curl_close($ch);

var_dump($output);
echo $output;

請求

curl -X GET 'https://api.laaffic.com/v3/getBalance'
-H 'Timestamp: {datetime}'
-H 'Api-Key: {apiKey}'
-H 'Sign: {sign}'
-H 'Content-Type: application/json;charset=UTF-8'

請求

import hashlib
import time
import requests
import json

base_url = "https://api.laaffic.com/v3"
api_key = "your api key"
api_pwd = "your api secret"

def create_headers():
  timestamp = int(time.time())
  s = "%s%s%s" % (api_key, api_pwd, str(timestamp))
  sign = hashlib.md5(s.encode(encoding='UTF-8')).hexdigest()
  headers = {
    'Content-Type': 'application/json;charset=utf-8',
    'Sign': sign,
    'Timestamp': str(timestamp),
    'Api-Key': api_key
  }
  return headers

headers = create_headers()

url = "%s/getBalance" % base_url
print(url)

rsp = requests.get(url, headers=headers)
if rsp.status_code == 200:
    res = json.loads(rsp.text)
  print(res)

響應示例

{
    "status": "0",
    "reason": "success",
    "balance": "99.990000",
    "gift": "50.00000",
    "credit": "0"
}