API Call Description

Host

Sandbox: https://api.sandbox.lemft.com

Production: https://api.lemft.com

Version

Limit

接口在调用时，相同的请求URL，会进行迸发限制，同一时刻多次调用时，只有一次会成功，其余的会因限制返回错误 10004（currently too many requests, try again later）。

Http Method

HTTP GET|POST

Common Header

字段	类型	是否必填	描述
timestamp	long	是	当前UTC时间戳，请使用UTC 0时区。如果timestamp值小于当前时间值设定的范围，接口会返回错误码 10003（request time exceeded limit）
signature	string	是	通过签名算法，对参数进行签名后得签名串，签名算法请查看Sign章节。
traceid	string	否	请求唯一id，非必填项，建议调用方将traceid填写，并且保证traceid唯一。

Common Param

字段	类型	是否必填	描述
customer_id	long	是	客户id，在Global平台认证客户后，可获得customer_id。
app_id	long	是	应用id，在Global平台上创建的应用id。
key	string	是	授权key，在Global平台上创建的授权key，并需要与应用id绑定。

Sign

使用HMAC-SHA256签名进行参数签名

获取当前UTC 0时区时间戳，如：1697696752。

获取调用接口需要的参数 Json Body，并转成字符串格式，如：{\"min\":0,\"max\":1000}。

拼接 param 和 timestamp，即： param + timestamp，如：{\"min\":0,\"max\":1000}1697696752。

通过apiKey(签名密钥)和param，进行HMAC-SHA256签名，apiKey 请在 Global平台上申请。

需要注意：区分apiKey和Common Param中的key，这是两个不同的字段。Common Param中的key是用于app_id的授权校验，签名要用apiKey(签名密钥)

示例

Java

Go

Php

常见错误码

错误码	描述
10001	param error
10002	signature error
10003	request time exceeded limit
10004	currently too many requests, try again later
10005	system error

API Call Description

Host#

Version#

Limit#

Http Method#

Common Header#

Common Param#

Sign#

示例#

Java#

Go#

Php#

常见错误码#