1. Device Login
V8STD
  • Index
  • Inventory
    • TrfRsAdj
      POST
    • GRConfirm
      POST
    • ItemStockOnHand
      POST
    • GRUpdate
      POST
    • QtyAdj
      POST
    • TrfRsOut
      POST
    • QtyAdjConfirm
      POST
    • StkCntUpdate
      POST
    • GoodsReturnUpdate
      POST
    • GoodsReturnConfirm
      POST
    • TrfRsIn
      POST
    • TrfReqConfirm
      POST
    • TrfReq
      POST
    • POUpdate
      POST
    • POStatusChange
      POST
    • TrfRsConfirm
      POST
  • Inventory Enquiry
    • enq_TrfRsOsNote
      POST
    • enq_TrfRs
      POST
  • Master
    • itemSearchTTPos
      POST
  • Master Export
    • barCodeExport
      POST
    • storeExport
      POST
    • staffExport
      POST
    • ReasonExport
      POST
    • itemPriceExport
      POST
    • itemMasterExport
      POST
    • tenderExport
      POST
  • Master Import
    • itemPriceImport
    • barcodeImport
    • itemMasterImport
    • staffImport
  • Sales
    • salesTransStd
    • salesValidate
    • salesVoid
    • salesMemoStdEnquiry
  • Vip
    • vipBonusAdjustVipStd
    • vipSearchVipStd
    • vipMasterBasicCreateVipStd
    • vipBonusEnquiryVipStd
  • Device Login
    • Get_APIKEY
      POST
  1. Device Login

Get_APIKEY

测试中
POST
/posservice/rest/posdevice/login
Get_APIKEY 設備驗證接口,獲取APIKEY
提供第三方APIKEY 接口,需要設置第三方programName 對應devicelicense (XF_REGISTRATIONPRESET=Y)和 定義locationcode (即店鋪號)和 activationCode (非預先註冊)
第三方獲取 loginSecretId 之後將 該值放在普通請求的 "apiKey" 字段中 或者 放在請求 header “apiKey”中,就可以通過驗證。
Provide third-party APIKEY interface, Need to set third-party programName for devicelicense (XF_REGISTRATIONPRESET=Y) and define locationcode (i.e. shop number) and activationCode (non-pre-registered)
The third party takes loginSecretId and puts the value in the "apiKey" field of the normal request or in the request header "apiKey" to pass the verification.
PS. For ESPOSV85 需要配置预允许TALBE-xf_devicepreapproved

请求参数

Authorization
在 header 添加参数
apiKey
示例:
apiKey: ********************
Body 参数application/json

示例
{
    "content": {
        "programName": "APIEXTERNAL",
        "locationCode": "HKCB",
        "deviceId": "1", 
        "activationCode": "3204B21A343FCBD07D09FA2EE9D63526"
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST '/posservice/rest/posdevice/login' \
--header 'apiKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "content": {
        "programName": "APIEXTERNAL",
        "locationCode": "HKCB",
        "deviceId": "1", 
        "activationCode": "3204B21A343FCBD07D09FA2EE9D63526"
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "asynCode": null,
    "asynMessage": null,
    "asynStatus": 0,
    "content": {
        "activationCode": "3204B21A343FCBD07D09FA2EE9D63526",
        "configPropertyValues": null,
        "deviceId": "1",
        "licenseOverLimitTolerant": null,
        "locationCode": "HKCB",
        "loginSecretId": "#56A011DBFC1F135F9CEB4879AFB5D573BB07DCFF80331015518FECE984CD5D61",
        "loginSecretLiveHours": 240,
        "registrationCode": "2024-09-27 17:55:34.160,2024-09-27 17:55:34.160,6,9AB93FBBAD2D828E147695FEDA2EB62CF618733FE686CC95",
        "reloginDurationHours": 6,
        "serverLostTolerant": null,
        "status": "SUCCESS",
        "success": true
    },
    "error": false,
    "errorBatchLog": null,
    "errorCode": 0,
    "errorMessage": null
}
🟢200处理数据失败
🟠404响应失败
修改于 2025-09-10 08:32:32
上一页
vipBonusEnquiryVipStd
Built with