查詢訂單（orders）

回傳購買記錄，含專屬 APP 憑證。支援分頁。僅限銷售/管理員角色呼叫。

介面資訊

項目	說明
介面位址	`POST /api.php`
action	`orders`
認證方式	全域應用 APP ID / APP KEY
角色限制	僅銷售/管理員

請求參數

參數	類型	必填	說明
`page`	int	否	頁碼，預設 1
`limit`	int	否	每頁筆數，預設 20，最大 50

請求範例

{
    "action": "orders",
    "app_id": "68B0FA47FEC9E7EBC4BF80F8",
    "app_key": "2b901515a427b6c0b68f866eece70e0d2ecf687146022412",
    "page": 1,
    "limit": 20
}

PHP

<?php
$app_id = '68B0FA47FEC9E7EBC4BF80F8';
$app_key = '2b901515a427b6c0b68f866eece70e0d2ecf687146022412';
$url = 'https://yunsapi.com/api.php';

$params = [
    'action'  => 'orders',
    'app_id'  => $app_id,
    'app_key' => $app_key,
    'page'    => 1,
    'limit'   => 20,
];

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

$resp = curl_exec($ch);
curl_close($ch);
echo $resp;

Java

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiDemo {
    static final String URL = "https://yunsapi.com/api.php";
    static final String APP_ID = "68B0FA47FEC9E7EBC4BF80F8";
    static final String APP_KEY = "2b901515a427b6c0b68f866eece70e0d2ecf687146022412";

    public static void main(String[] args) throws Exception {
        String body = "{\"action\":\"orders\",\"app_id\":\"" + APP_ID + "\",\"app_key\":\"" + APP_KEY + "\",\"page\":1,\"limit\":20}";
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest req = HttpRequest.newBuilder()
                .uri(URI.create(URL))
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(body))
                .build();
        HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
        System.out.println(resp.body());
    }
}

回應範例

{
    "code": 0,
    "msg": "success",
    "data": {
        "total": 5,
        "page": 1,
        "limit": 20,
        "list": [
            {
                "id": "20",
                "api_name": "身份證二要素查驗",
                "api_code": "idcard2check",
                "amount": 1.0000,
                "calls": "40",
                "used": "26",
                "remain": 14,
                "expire_time": "2026-09-12 03:22:50",
                "order_app_id": "8660A87AE320F5D9E7AAF92C",
                "order_app_key": "a740e240f22d641bd950388138503d6c2f878db74a72e495"
            }
        ]
    }
}

回應參數

參數	類型	說明
`data.total`	int	總筆數
`data.page`	int	目前頁碼
`data.limit`	int	每頁筆數
`data.list[].id`	string	訂單 ID
`data.list[].api_name`	string	API 名稱
`data.list[].api_code`	string	API 程式碼
`data.list[].amount`	float	支付金額
`data.list[].calls`	string	總呼叫次數（買斷為 null）
`data.list[].used`	string	已使用次數
`data.list[].remain`	int	剩餘次數
`data.list[].expire_time`	string	到期時間
`data.list[].order_app_id`	string	專屬 APP ID
`data.list[].order_app_key`	string	專屬 APP KEY