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

ClientID & ClientSecret

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Body

application/json

reqidstring · min: 1Required

Request ID from NFC scan

Responses

200

Success

application/json

messagestringRequired

Status message

tokenstringRequired

JWE encrypted token containing NFC data

400

Bad Request - Invalid input parameters

application/json

500

Internal Server Error

application/json

post

/sino-connect/nfc/callback

HTTPcURLJavaScriptPython

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

ClientID & ClientSecret

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Body

application/json

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

200

200 Success

application/json

messagestringOptional

tokenstringOptional

urlstringOptional

post

/sino-connect/face-rec/request

HTTPcURLJavaScriptPython

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

ClientID & ClientSecret

x-client-idstringRequired

Client ID in x-client-id header.

x-client-secretstringRequired

Client Secret in x-client-secret header.

Body

application/json

tokenstringRequired

Responses

200

200 Success

application/json

faceImagestringOptional

sceneImagestringOptional

messagestringOptional

202

Pending

application/json

post

/sino-connect/face-rec/callback

HTTPcURLJavaScriptPython

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"
}

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