Parking Software LAN Interface

Documentation

This document includes an introduction to the LAN interface, classification and prerequisites for using the LAN interface, and explanations of the corresponding interface documentation for the LAN interface.

1. Introduction

The LAN interface is designed for third-party integration scenarios where parking lot-related data is not intended to be uploaded to the platform, but there is a need to perform related data queries, additions, modifications, and receive entry/exit data from the software side within the local area network.

The LAN interface is divided into three categories: Query, Notification, and Callback.

• Query : Refers to requesting relevant data from the software side via the interface, such as querying records of vehicles in the lot or payment records.
• Notification: Refers to sending relevant data to the software via the interface, after which the software saves the data, such as adding a license plate or controlling the gate to open.
• Callback: Refers to the software uploading relevant data to the integrator’s server, where the integrator is responsible for saving this type of data, such as uploading available parking spaces, entry information, or exit information.

2. Categories

The LAN interface is divided into two versions: V2.0 and V3.0:

• V2.0 interface: This version offers a more comprehensive set of functional interfaces and provides greater convenience for interface invocation.
• V3.0 interface: This version utilizes the MQTT protocol for integration, effectively overcoming network access restrictions and ensuring real-time and reliable data interaction.

3. V2.0 Interface Documentation (HTTP)​

This service is the LAN interface designed for third-party developers.By calling the API interfaces we provide, developers can integrate the following functions into their own applications or services:querying information related to local parking lot operations, parking payment, vehicle registration, Gate Release Record, and other features.

3.1 Development Guide

This document primarily covers the acquisition of parameters and software-side configurations during integration, as well as basic rules and related type enumerations (payment methods, license plate colors, callback interfaces, payment scenarios, order statuses, query operators, etc.). It also includes interface signature methods, handling of sensitive information, callback configuration instructions, and more.

3.1.1 Parameter Acquisition and Configuration

Calling the API requires the use of the appid, AppSecret and ParkKey parameters. These must be configured and filled in within the System Settings. The specific steps are shown below:

3.1.2 Basic Rules

Basic Information

All API requests must use HTTP.

Character Set

Interfaces use the UTF-8 character encoding.

Field Naming Rules

All parameter fields related to the interface adopt Pascal Case naming convention. Similar to Camel Case but with the first letter capitalized, e.g., FirstName, LastName, UserName.

Request Unique Identifier

The parking lot’s local open interface assigns a unique identifier to each received request. This unique identifier is included in the response’s ResultId. When assistance with parking lot interface development is needed, please provide the request’s unique identifier and relevant parking lot logs to help us locate the specific request more quickly.

Date Format

All date objects follow the format examples defined below:

yyyy-MM-dd HH:mm:ss
yyyy-MM-dd HH:mm:ss:fff
yyyy-MM-dd

Parameter Format

Interface request parameter type uses Content-Type=application/json.

3.1.3 Interface Authentication

Overview

• This document provides a detailed description of the signature-logic implementation for open-interface requests to the parking-lot system.
• The logic covers request-parameter processing, sorting, and HMAC-SHA256 signing.

Signature Generation Steps

1. Prepare data

   • Collect the items that will take part in the signature: AppId, ParkKey, TimeStamp, Nonce, Data.

2. Process Data

   • Sort every key/value pair in Data by ASCII code (ascending).
   • Concatenate the pairs with “&” and convert the whole string to lower-case.
   • Compute the MD5 hash of the resulting string (32-char hex, UTF-8).

   Rules

   • If Data is an array or collection, convert it to a list, process each element individually, then join the results with “&”.
   • If Data is a single object, sort its fields directly.
   • When Data is null, still include it in the signature as Data= (empty value).
     Any other parameter whose value is null is omitted from the signature string.

3. Build the signature string

   • Concatenate the following five items in exact order, separated by “&”: AppId, Data (already hashed), ParkKey, TimeStamp, Nonce.

4. Sign

   • Convert the entire concatenated string to lower-case.
   • Compute HMAC-SHA256 using AppSecret as the key.
   • Encode the digest as Base64 and convert it to lower-case.
   • The result is the final signature value.

Example

Given the request body:

{
    "ParkKey": "1702399313365243",
    "AppId": "fkqju0n1",
    "TimeStamp": "1704527859009",
    "Nonce": "928885",
    "Sign": "x1aeqmo3/hs9cbhlbnzburgskf1gvd/lil2t/iasiyo=",
    "Data": [
        { "Index": 1, "Url": "http://aebhfqld.gt/tgmjt " },
        { "Index": 3, "Url": "http://qtdupkzq.sd/dsicxsc " },
        { "Url": "http://dfxkmte.tv/mpeop ", "Index": 2 },
        { "Url": "http://hdphhisif.ni/uejufkem ", "Index": 4 }
    ]
}

Step 1 – normalise Data

Sort all key/value pairs by key (ASCII ascending):

Index=1&Url=http://aebhfqld.gt/tgmjt&Index=2&Url=http://dfxkmte.tv/mpeop&Index=3&Url=http://qtdupkzq.sd/dsicxsc&Index=4&Url=http://hdphhisif.ni/uejufkem

Lower-case the string and compute MD5 → assume the digest is
md5Result = 5d41402abc4b2a76b9719d911017c592

Step 2 – build the pre-sign string

AppId=fkqju0n1&Data=5d41402abc4b2a76b9719d911017c592&ParkKey=1702399313365243&TimeStamp=1704527859009&Nonce=928885

Step 3 – sign

• Lower-case the entire string and run HMAC-SHA256 with AppSecret.
• Base64-encode the digest and lower-case it → the value must match the Sign field in the request.

Remarks

• Every key/value pair must be sorted by ASCII code.
• The HMAC key is always AppSecret.
• TimeStamp must be a 13-digit Unix timestamp (milliseconds).
• Nonce must be a random string to prevent replay attacks.
• When Data is null, still include Data= in the signature string; all other null fields are skipped.
• In callback interfaces, some image Base64 fields are not included in signature calculation. The specific field remarks shall prevail.

Code Samples

HMAC-SHA256 helper (C#)

    /// <summary>
    /// HMAC-SHA256 signature
    /// </summary>
    /// <param name="data">data to be signed</param>
    /// <param name="secret">secret key</param>
    /// <returns>signed data, base64 encoded, converted to lower-case</returns>
    public static string HmacSha256Sign(string data, string secret)
    {
        try
        {
            var encoding = new UTF8Encoding();
            var keyByte = encoding.GetBytes(secret);
            var messageBytes = encoding.GetBytes(data);
            using var hmacsha256 = new System.Security.Cryptography.HMACSHA256(keyByte);
            var hashmessage = hmacsha256.ComputeHash(messageBytes);
            var result = Convert.ToBase64String(hashmessage);
            return result.ToLower();
        }
        catch (Exception ex)
        {
            OpenApiLog.WriteLog("HMAC-SHA256 signature exception", ex);
            return string.Empty;
        }
    }

#####Convert Data to sorted string (C#)

    /// <summary>
    /// Sort Data by ASCII code (ascending) and convert to string
    /// </summary>
    /// <param name="data">request data</param>
    /// <returns>converted string</returns>
    private static string ConvertDataToString(object data)
    {
        // if data is null, return empty string
        if (data == null)
        {
            return string.Empty;
        }

        // if data is array or collection
        if (data.GetType().IsArray || data is IEnumerable<object>)
        {
            // convert array to list
            var dataList = ((IEnumerable<object>)data).ToList();
            // process each element in the list recursively
            var dataDictList = dataList.Select(ConvertDataToString);
            // use stable sort to ensure identical elements do not swap positions
            dataDictList = dataDictList.OrderBy(p => p, StringComparer.Ordinal).ToList();
            // convert each element to string and join with "&"
            return string.Join("&", dataDictList);
        }

        // if data is object
        // use reflection to get property values and convert to key-value pair sequence
        var dataDict = data.GetType().GetProperties()
            .Select(p =>
            {
                // get property value
                var value = p.GetValue(data);
                // if property value is array, process recursively
                if (value != null && (value.GetType().IsArray || value is IEnumerable<object>))
                {
                    value = ConvertDataToString(value);
                }
                // return key-value pair
                return new KeyValuePair<string, object>(p.Name, value);
            })
            // filter out key-value pairs whose value is null
            .Where(p => p.Value != null)
            // use stable sort on key-value pair sequence
            .OrderBy(p => p.Key, StringComparer.Ordinal)
            // convert key-value pair sequence to dictionary
            .ToDictionary(p => p.Key, p => p.Value);

        // convert dictionary to string and join with "&"
        return string.Join("&", dataDict.Select(p => $"{p.Key}={p.Value}"));
    }

3.1.4 Type Enumeration List

LicensePlateColorEnum

PaymentMethodEnum

CallbackInterfaceEnum

RequestResultCodeEnum

PaymentScenarioEnum

QueryOperatorEnum

Field Notice
Fields inside arrays returned by query-data interfaces do not support conditional filtering!

Operator Notes

OrderStatusEnum

ManualGateOperationTypeEnum

AbnormalPassageTypeEnum

3.1.5 Sensitive Information Decryption

Description
When sensitive information is returned by a query, it is encrypted and must be decrypted.

How to Tell if a Field Needs Decryption
Encrypted fields are usually returned in Base64 format and are marked “requires decryption” in the field description.

Decryption Method

Data is encrypted/decrypted with AES. Key details are in the table below:

Sample Code
C# example

    /// <summary>
    /// Decrypts a value using the AES algorithm.
    /// </summary>
    /// <param name="value">Encrypted value to decrypt.</param>
    /// <param name="key">Encryption key.</param>
    /// <param name="iv">Initialization vector.</param>
    /// <returns>Decrypted value as a string.</returns>
    public static string AesDecrypt(string value, string key, string iv)
    {
        // Return input as-is if null or empty
        if (string.IsNullOrEmpty(value)) return value;

        // Validate key
        if (key == null) throw new Exception("Encryption key not set.");
        if (key.Length < 16) throw new Exception("Key length must be at least 16 characters.");
        if (key.Length > 32) throw new Exception("Key length must not exceed 32 characters.");
        if (key.Length != 16 && key.Length != 24 && key.Length != 32)
            throw new Exception("Key length is ambiguous.");

        // Validate IV length if provided
        if (!string.IsNullOrEmpty(iv) && iv.Length < 16)
            throw new Exception("IV length must be at least 16 characters.");

        // Convert key to byte array
        var keyBytes = Encoding.UTF8.GetBytes(key);

        // Convert Base64-encoded cipher text to byte array
        var encryptedBytes = Convert.FromBase64String(value);

        // Create RijndaelManaged instance
        using (var aes = new RijndaelManaged())
        {
            // Set IV: use provided value or first 16 bytes of key
            aes.IV = !string.IsNullOrEmpty(iv) ? Encoding.UTF8.GetBytes(iv) : keyBytes.Take(16).ToArray();

            // Set encryption key
            aes.Key = keyBytes;

            // Set cipher mode to CBC
            aes.Mode = CipherMode.CBC;

            // Set padding mode to PKCS7
            aes.Padding = PaddingMode.PKCS7;

            // Create decryptor
            var cryptoTransform = aes.CreateDecryptor();

            // Transform cipher text back to original bytes
            var resultArray = cryptoTransform.TransformFinalBlock(encryptedBytes, 0, encryptedBytes.Length);

            // Convert result bytes to UTF-8 string
            return Encoding.UTF8.GetString(resultArray);
        }
    }

3.1.6 Callback Configuration Instructions

1. When is a callback service required?
When integrating third-party parking services, if you need the parking system to notify you of vehicle entry/exit, payment details, monthly ticket registration, monthly ticket extensions, monthly ticket cancellations, or parking space updates by area, you must configure a callback service.

2. How to configure the callback service
During integration, the developer must call the local parking service’s “Set Callback Parameters” API to enable the required callback interfaces. If no parameters are set, no callbacks will be triggered by default.

3. What functions must the callback service implement?
The callback service must expose the APIs described in the callback interface documentation and return data in the specified format. To ensure data integrity, signature verification is recommended.

4. Callback service limitations
If the parking system fails to deliver a callback notification, it will retry at most 3 times and then stop to avoid infinite loops.
To recover missing data, call the “Re-pull Failed Callbacks” API manually.

Note: Developers must handle any business-level exceptions themselves. Once a callback has failed, repeating it is meaningless. Log the details and respond to the parking service with “processed” to terminate the retry cycle.

5. Signature-verification tips for callbacks
Some callback fields contain boolean, float, or integer values.
Do not convert them arbitrarily (e.g., amount 0.00 must remain 0.00, not 0), or the signature check will fail.

4. Query Interfaces（V2.0）

Query Zone Information

Brief Description

• This API is used to query zone information.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774578368997",
    "Nonce": "nfmpg55zpdg5",
    "Sign": "rqvchzlkui1kws1jtinrltypgohs7idy6yp8tmfmcqy="
}

Return Parameter Description

Return Example

{
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "TotalCount": 1,
        "Results": [
            {
                "Uid": 1,
                "No": "1772492942540835",
                "AreaName": "Outer Field",
                "AreaType": 0,
                "AreaSpaceNum": 500,
                "PUid": 0,
                "Level": 0,
                "CreationTime": "2026-03-18 02:32:14"
            }
        ]
    },
    "ResultCode": 200,
    "ResultMsg": "Query data successfully",
    "ResultId": "2037355457299906560"
}

Query Booth Information

Brief Description

• This API is used to query booth information.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774578631205",
  "Nonce": "cfh6rc82o2xd",
  "Sign": "neekq5zdwi6a3bcn0owtfwxqo9nmher8q8wqbc+4sly="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 1,
        "No": "1772492942363478",
        "Name": "127.0.0.1",
        "Category": 1,
        "IP": "192.168.22.23",
        "TcpPort": null,
        "BSPort": 7702,
        "CreationTime": "2026-03-02 23:09:02",
        "Longitude": null,
        "Latitude": null
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037356557084164096"
}

Query Lane Information

Brief Description

• This API is used to query lane information.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774580431571",
    "Nonce": "lmwjhyoe85x6",
    "Sign": "s6gifh7clisx+rfpvqku57sfelrjb5skoikd+ryq9ky="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 2,
    "Results": [
      {
        "Uid": 1,
        "No": "1",
        "LaneName": "Entrance Lane",
        "LaneType": 1,
        "IdInterval": 3,
        "IsBackCar": 0,
        "IsCharge": 0,
        "OpenGateAndVoice": 1,
        "SentryHostNo": "1772492942363478",
        "CreationTime": "2026-03-02 23:09:02",
        "IsSense": 1,
        "IsSameInOut": 0,
        "SameInOutLaneNo": null,
        "SameInOutType": 0,
        "IsEnableBoard": 0,
        "LaneLinkAreas": [
          {
            "No": "1774609216714465",
            "AreaNo": "1772492942540835",
            "InOutMode": 1
          }
        ]
      },
      {
        "Uid": 2,
        "No": "2",
        "LaneName": "Exit Lane",
        "LaneType": 1,
        "IdInterval": 3,
        "IsBackCar": 0,
        "IsCharge": 1,
        "OpenGateAndVoice": 1,
        "SentryHostNo": "1772492942363478",
        "CreationTime": "2026-03-02 23:09:02",
        "IsSense": 1,
        "IsSameInOut": 0,
        "SameInOutLaneNo": null,
        "SameInOutType": 0,
        "IsEnableBoard": 0,
        "LaneLinkAreas": [
          {
            "No": "1774609216715573",
            "AreaNo": "1772492942540835",
            "InOutMode": 0
          }
        ]
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037364113160568832"
}

Query Plate Type Information

Brief Description

• This API is used to query plate type information.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774583643820",
    "Nonce": "8pi08ligfp02",
    "Sign": "mxzqjrpgn2ahlyqvckroofp4ivq/e0xjh9l4br1txay="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 18,
    "Results": [
      {
        "Uid": 1,
        "No": "1772492942389944",
        "ParkingCardTypeName": "Monthly Rental Car A",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3652"
      },
      {
        "Uid": 2,
        "No": "1772492942389782",
        "ParkingCardTypeName": "Monthly Rental Car B",
        "IsMoreCar": true,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3653"
      },
      {
        "Uid": 3,
        "No": "1772492942389940",
        "ParkingCardTypeName": "Monthly Rental Car C",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3654"
      },
      {
        "Uid": 4,
        "No": "1772492942389560",
        "ParkingCardTypeName": "Monthly Rental Car D",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3655"
      },
      {
        "Uid": 5,
        "No": "1772492942389853",
        "ParkingCardTypeName": "Monthly Rental Car E",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3661"
      },
      {
        "Uid": 6,
        "No": "1772492942389129",
        "ParkingCardTypeName": "Monthly Rental Car F",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3662"
      },
      {
        "Uid": 7,
        "No": "1772492942389699",
        "ParkingCardTypeName": "Monthly Rental Car G",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3663"
      },
      {
        "Uid": 8,
        "No": "1772492942389607",
        "ParkingCardTypeName": "Monthly Rental Car H",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3664"
      },
      {
        "Uid": 9,
        "No": "1772492942389506",
        "ParkingCardTypeName": "Temporary Car A",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3651"
      },
      {
        "Uid": 10,
        "No": "1772492942389238",
        "ParkingCardTypeName": "Temporary Car B",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3650"
      },
      {
        "Uid": 11,
        "No": "1772492942389881",
        "ParkingCardTypeName": "Temporary Car C",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3649"
      },
      {
        "Uid": 12,
        "No": "1772492942389922",
        "ParkingCardTypeName": "Temporary Car D",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3648"
      },
      {
        "Uid": 13,
        "No": "1772492942389720",
        "ParkingCardTypeName": "Temporary Car E",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3647"
      },
      {
        "Uid": 14,
        "No": "1772492942389279",
        "ParkingCardTypeName": "Temporary Car F",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3646"
      },
      {
        "Uid": 15,
        "No": "1772492942389113",
        "ParkingCardTypeName": "Temporary Car G",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3645"
      },
      {
        "Uid": 16,
        "No": "1772492942389629",
        "ParkingCardTypeName": "Temporary Car H",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3644"
      },
      {
        "Uid": 17,
        "No": "1772492942389454",
        "ParkingCardTypeName": "Free Car",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3656"
      },
      {
        "Uid": 18,
        "No": "1772492942389308",
        "ParkingCardTypeName": "Stored Value Car",
        "IsMoreCar": false,
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null,
        "Category": "3657"
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037377586011602944"
}

Query Plate Color Information

Brief Description

• This API is used to query plate information.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774583183257",
  "Nonce": "92an8dgzpc9n",
  "Sign": "np8x2cbizdylxokvecrq1e0mhmxin4mitk6qc1glh5e="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 9,
    "Results": [
      {
        "Uid": 1,
        "No": "1772492942395203",
        "VehicleTypeName": "Blue Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 2,
        "No": "1772492942395558",
        "VehicleTypeName": "Yellow Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 3,
        "No": "1772492942395297",
        "VehicleTypeName": "Green Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 4,
        "No": "1772492942395388",
        "VehicleTypeName": "Black Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 5,
        "No": "1772492942395917",
        "VehicleTypeName": "White Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 6,
        "No": "1772492942395140",
        "VehicleTypeName": "No Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 7,
        "No": "1772492942395720",
        "VehicleTypeName": "0 Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 8,
        "No": "1772492942395498",
        "VehicleTypeName": "Yellow-Green Plate Vehicle",
        "CreationTime": "2026-03-02 23:09:02",
        "OperatorName": null
      },
      {
        "Uid": 9,
        "No": "1773111596539522",
        "VehicleTypeName": "test",
        "CreationTime": "2026-03-10 02:59:56",
        "OperatorName": null
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037375654295535616"
}

Query Lane Ground Loop Barrier Status

Brief Description

• This API is used to query the status of ground loop and barrier gates in a lane.

Request URL

• http://localhost:8888/Api/V2/OpenApi/GetLaneStatus

Request Method

• GET

Request Content-Type

• application/json

Request Parameters

Body Parameters

Request Example

{
    "ParkKey": "1772492942362538",
    "AppId": "xb5glg0hgz40",
    "TimeStamp": "1774591364770",
    "Nonce": "389012",
    "Sign": "fy23v3b2rlby2geg94sax3tge0j2fdd2hszwtzquf18=",
    "Data": {
        "LaneNo": "1"
    }
}

Return Parameter Description

Return Example

{
    "Data": {
        "GataStatus": -1,
        "GateLongOpen": 0,
        "GSStatus": -1,
        "IDCameraStatus": 0
    },
    "ResultCode": 200,
    "ResultMsg": "Lane ground loop gate status retrieved successfully!",
    "ResultId": "2037409969930797056"
}

Query Lane Current Order

Brief Description

• This API is used to query the current order of a lane.

Request URL

• http://localhost:8888/Api/V2/OpenApi/GetLaneOrder

Request Method

• GET

Request Content-Type

• application/json

Request Parameters

Body Parameters

Request Example

{
    "ParkKey": "1772492942362538",
    "AppId": "xb5glg0hgz40",
    "TimeStamp": "1774593426011",
    "Nonce": "272946",
    "Sign": "cmwzgjt3qj+thzq3myrdjqgzbng3qkrdid/kqriqlwo=",
    "Data": {
        "LaneNo": "2"
    }
}

Return Parameter Description

Return Example

{
    "Data": {
        "OrderNo": "1774546385410449-162YRG",
        "ChargeMoney": 5.0,
        "CouponKey": []
    },
    "ResultCode": 200,
    "ResultMsg": "Lane order information retrieved successfully!",
    "ResultId": "2037418615238590464"
}

Query Vehicle Record

Brief Description

• This API is used to query vehicle records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774593936520",
    "Nonce": "l7vkb8xj0ul7",
    "Sign": "poxjnfarjespzerzqole5tlfitetgn/hlhp3/kjveea="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 23,
        "No": "1774336597411515",
        "LicensePlateNumber": "DASH1",
        "SystemSpotNumber": "C00003",
        "ParkingSpotNumber": "",
        "OwnerParkingSpaceCount": 1,
        "OwnerName": "",
        "OwnerNo": "1774322212039836",
        "OwnerIDCard": "",
        "OwnerLicense": "",
        "OwnerAddress": "",
        "PhoneNumber": "",
        "Email": "",
        "StartTime": "2026-03-24 00:00:00",
        "EndTime": "2026-04-23 23:59:59",
        "StoredVehicleBalance": 0,
        "VehicleTypeNo": "1772492942395203",
        "VehicleTypeName": "Blue Plate Vehicle",
        "ParkingCardTypeNo": "1772492942389944",
        "ParkingCardTypeName": "Monthly Rental Car A",
        "OperatorName": "qq",
        "CreationTime": "2026-03-24 03:16:52",
        "Remarks": "",
        "Status": 1,
        "EnableOffline": 1,
        "IsDeleteOwner": false,
        "StopSpaceList": [
          {
            "No": "1774336597411678",
            "Type": 0,
            "AreaNos": "[\"0\"]",
            "AreaName": "All Zone",
            "SpaceCount": 1
          }
        ],
        "StatusText": "Normal"
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037420756380450816"
}

Query Blacklist Records

Brief Description

• This API is used to query blacklist records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774666337712",
    "Nonce": "gzwnmt2f85kn",
    "Sign": "94yrnyiz9kvdnozdfomnirgg+klb2mzgrmfoccscqhk="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 3,
        "No": "BL1774695130227262",
        "LicensePlateNumber": "ABC123",
        "OwnerName": "",
        "PhoneNumber": "",
        "StartTime": "2026-03-28 00:00:00",
        "EndTime": "2026-04-30 00:00:00",
        "Remarks": "1",
        "CreationTime": "2026-03-28 10:52:10",
        "OperatorName": "qq",
        "Status": 1
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037724429413285888"
}

Query Parking Order Records

Brief Description

• Query parking order records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
    "AppId": "xb5glg0hgz40",
    "Data": {
        "PageIndex": 1,
        "PageSize": 20,
        "OrderBy": "Uid",
        "OrderType": 0,
        "QueryCondition": [

        ]
    },
    "ParkKey": "1772492942362538",
    "TimeStamp": "1774666807228",
    "Nonce": "b4q1jiesvz40",
    "Sign": "5uihmatmcmrzdekraeipvyaoragmflzkpbli1ezbjl4="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 140,
        "OrderNo": "1774695602882864-BCDE11",
        "LicensePlateNumber": "ABCDE11",
        "EntryTime": "2026-02-27 08:59:25",
        "ExitTime": "0001-01-01 00:00:00",
        "EntryLaneNo": "1",
        "EntryLaneName": "Entrance Lane",
        "ExitLaneNo": null,
        "ExitLaneName": null,
        "EntryOperatorName": "qq",
        "ExitOperatorName": null,
        "ParkingAreaNo": "1772492942540835",
        "ParkingAreaName": "Outer Field",
        "VehicleTypeNo": "1772492942395203",
        "VehicleTypeName": "Blue Plate Vehicle",
        "EntryImageUrl": "",
        "ExitImageUrl": null,
        "ParkingCardTypeNo": "1772492942389506",
        "ParkingCardTypeName": "Temporary Car A",
        "OrderStatus": 200,
        "IsFreePass": false,
        "FreePassReason": null,
        "TotalAmountDue": 0,
        "TotalAmountPaid": 0,
        "IsVehicleLocked": false,
        "Remarks": ""
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037726398689345536"
}

Query Payment Records

Brief Description

• This API is used to query payment records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774667424134",
  "Nonce": "gqxypbbwp95d",
  "Sign": "1a1t6trlfdzbjtboxnx2hk0cepz4of+3m7gx0i9q+c8="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 33,
        "No": "MC1774322212074210",
        "OrderNo": "",
        "LicensePlateNumber": "DASH1",
        "OrderType": "5902",
        "SystemSpotNumber": "C00003",
        "VehicleTypeNo": "1772492942395203",
        "VehicleTypeName": "Blue Plate Vehicle",
        "ParkingCardTypeNo": "1772492942395203",
        "ParkingCardTypeName": "Monthly Rental Car A",
        "StartTime": "2026-04-23 23:59:59",
        "EndTime": "2026-03-24 00:00:00",
        "BeforeEndTime": null,
        "OwnerNo": "1774322212039836",
        "OwnerName": "",
        "TotalAmountDue": 0,
        "TotalAmountPaid": 0,
        "DiscountAmount": 0,
        "StoredValueDeduction": 0,
        "SelfMoney": 0,
        "OutReduceMoney": 0,
        "PaymentMethod": "79001",
        "PaymentStatus": 1,
        "EntryTime": null,
        "PaymentTime": "2026-03-24 03:16:52",
        "ParkingDuration": 0,
        "Remarks": "",
        "OperatorName": "qq",
        "CreationTime": "2026-03-24 03:16:52",
        "PaymentScene": 0
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037728986168066048"
}

Query Payment Detail Records

Brief Description

• This API is used to query payment detail records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774668088594",
  "Nonce": "d8b74lmheaiz",
  "Sign": "4kwgodq4slyy1w6nsibfve7ln1vxvzqwaec2gzmgiuu="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 33,
        "No": "PD1774322212119978-ASH1",
        "PaymentOrderNo": "MC1774322212074210",
        "OrderNo": "MC1774322212074210",
        "OrderDetailNo": null,
        "StartTime": null,
        "EndTime": "2026-03-24 03:16:52",
        "TimeCount": 0,
        "OrderType": "5902",
        "AreaNo": "",
        "AreaName": null,
        "LicensePlateNumber": "DASH1",
        "ParkingCardTypeNo": "1772492942389944",
        "ParkingCardTypeName": "Monthly Rental Car A",
        "VehicleTypeNo": "1772492942395203",
        "VehicleTypeName": "Blue Plate Vehicle",
        "PaymentMethod": "79001",
        "TotalAmountDue": 0,
        "DiscountAmount": 0,
        "TotalAmountPaid": 0,
        "PaymentStatus": 1,
        "PassageLaneNo": null,
        "Remarks": null,
        "CreationTime": "2026-03-24 03:16:52",
        "OperatorName": "qq",
        "StoredValueDeduction": 0
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037731773102718976"
}

Query Gate Release Record

Brief Description

• This API is used to query gate release records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774668802564",
  "Nonce": "bcpf88dr2zvx",
  "Sign": "yjqgppa5xtzw/gu5yhyy+rhhvt/wvzjitz8eytzwpls="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 1,
        "No": "ER1774697600304463",
        "GateSwitchType": 1,
        "OrderNo": null,
        "LicensePlateNumber": null,
        "PassageLaneNo": "2",
        "PassageLaneName": "Exit Lane",
        "DeviceNo": "1772492942377879",
        "DeviceName": "Exit Camera",
        "VehicleTypeNo": null,
        "VehicleTypeName": null,
        "ParkingCardTypeNo": "1772492942389506",
        "ParkingCardTypeName": "Temporary Car A",
        "SpecialVehicleNo": "",
        "SpecialVehicleName": "",
        "PassageImageUrl": "http://192.168.22.23:8888/CameraCaptures//1772492942363478/202603/28/dfc7b20adf202603281133191563007_Online.jpg",
        "PassageTime": "2026-03-28 11:33:20",
        "OperatorName": "qq",
        "OperationTime": "2026-03-28 11:33:20",
        "Remarks": "[Exit Camera]Release gate successfully!",
        "TotalAmountPaid": 0
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037734767680585728"
}

Query Coupon Scheme

Brief Description

• This API is used to query coupon schemes.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters

Request Example

{
  "AppId": "xb5glg0hgz40",
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "OrderBy": "Uid",
    "OrderType": 0,
    "QueryCondition": []
  },
  "ParkKey": "1772492942362538",
  "TimeStamp": "1774669296136",
  "Nonce": "a33ys6g6sspg",
  "Sign": "tejosus65710mv720egz4ztpug3ai2zlgbqapdiwama="
}

Return Parameter Description

Return Example

{
  "Data": {
    "PageIndex": 1,
    "PageSize": 20,
    "TotalCount": 1,
    "Results": [
      {
        "Uid": 9,
        "No": "1774060298299594",
        "Name": "forfree",
        "Type": "103",
        "Amount": 0,
        "Duration": 0,
        "Ratio": 0,
        "VaildTime": null,
        "Enable": null,
        "Scene": 2,
        "CreationTime": "2026-03-21 02:31:38",
        "OperatorName": "admin"
      }
    ]
  },
  "ResultCode": 200,
  "ResultMsg": "Query data successfully",
  "ResultId": "2037736837838045184"
}

Query Plate Coupon Records

Brief Description

• This API is used to query plate coupon records.

Request URL

• http://localhost:8888/Api/V2/OpenApi/Query

Request Method

• POST

Request Content-Type

• application/json

Request Parameters

Query Parameters

Body Parameters