Sino Connect

Documentation for China NFC eID for the various endpoints that we offer.

Should be used in conjuction with the SDK provided by Fill Easy, to read Chinese ID card data.

Clients will need to retrieve the ReqID from their mobile application, and pass the Req ID in Poll Data to retrieve the encrypted data from our system.

NFC Poll

post

Used in conjunction with the SDK that we provide.

Authorizations
x-client-idstringRequired

API Key authentication using x-client-id and x-client-secret headers.

x-client-secretstringRequired

The client secret used for API key authentication.

Body
reqidstring · min: 1Required

Request ID from NFC scan

Responses
post
/sino-connect/nfc/callback
POST /sino-connect/nfc/callback HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 24

{
  "reqid": "smth-ddddddd"
}
{
  "message": "text",
  "token": "text"
}

Face Recognition Request

post

Initialize a face recognition session by passing your redirect URL.

Returns a launch URL (open on a mobile browser) and a JWT token that you must keep for polling status. Use the returned url to open an in-app web view or the system browser on the phone. After the user completes or cancels the H5 flow, the browser is redirected to your provided callback URL.

Authorizations
x-client-idstringRequired

API Key authentication using x-client-id and x-client-secret headers.

x-client-secretstringRequired

The client secret used for API key authentication.

Body
redirectstringRequired

Redirect URI after user authorization.

Browser: https URL to your website.

Mobile: Universal link (your-app://) or app scheme.

Example: https://www.yourwebsite.com/callback
Responses
post
/sino-connect/face-rec/request
POST /sino-connect/face-rec/request HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 33

{
  "redirect": "https://google.com"
}
200

200 Success

{
  "message": "Success",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uSWQiOiJlZDBhYzNhNTg3ZTY0YTFiYTkwNmRlYTk1YzY1YTQyOSIsImlhdCI6MTc1NjgxMTMwMX0.Ve72SAY9Yg0vMvYBepH7UrByVU7ZD6rYfNOxmKGARPQ",
  "url": "https://eidlink.h5.livedetect.cn/capture.html?token=ed0ac3a587e64a1ba906dea95c65a429"
}

Face Recognition Poll

post

Used to poll for the face recognition result after user action.

Authorizations
x-client-idstringRequired

API Key authentication using x-client-id and x-client-secret headers.

x-client-secretstringRequired

The client secret used for API key authentication.

Body
tokenstringRequired
Responses
post
/sino-connect/face-rec/callback
POST /sino-connect/face-rec/callback HTTP/1.1
Host: sandbox.staging-api.fill-easy.com
x-client-id: YOUR_API_KEY
x-client-secret: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 180

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzZXNzaW9uSWQiOiJlZDBhYzNhNTg3ZTY0YTFiYTkwNmRlYTk1YzY1YTQyOSIsImlhdCI6MTc1NjgxMTMwMX0.Ve72SAY9Yg0vMvYBepH7UrByVU7ZD6rYfNOxmKGARPQ"
}
200

200 Success

{
  "faceImage": "sjSM5hXbhv2kjOzh6vslK7...",
  "message": "Success"
}
PreviousSingpassNextOCR

Last updated