Official Integration Guide
For Websites & Apps

// Instantiate fio.js with your application's Public ID
const faceio = new faceIO("app-public-id");
function enrollNewUser(){
faceio.enroll({
  "locale": "auto", // Default user locale
  "payload": {
      /* The payload we want to associate with this particular user which is forwarded back to us upon future authentication of this user.*/
      "whoami": 123456, // Dummy ID linked to this particular user
      "email": "john.doe@example.com"
      }
  }).then(userInfo => {
      // User Successfully Enrolled! 
      alert(
          `User Successfully Enrolled! Details:
           Unique Facial ID: ${userInfo.facialId}
           Enrollment Date: ${userInfo.timestamp}
           Gender: ${userInfo.details.gender}
           Age Approximation: ${userInfo.details.age}`
      );
     console.log(userInfo);
     // handle success, save the facial ID (userInfo.facialId), redirect to the dashboard...
  }).catch(errCode => {
     // Something went wrong during enrollment, log the failure
     handleError(errCode);
  })
}

const faceio = new faceIO("app-public-id"); // Initialize with your application's Public ID
function authenticateUser(){
  faceio.authenticate({
      "locale": "auto" // Default user locale
  }).then(userData => {
      console.log("Success, user identified")
      // Grab the facial ID linked to this particular user which will be same
      // for each of his successful future authentication. FACEIO recommend 
      // that you rely on this Facial ID if you plan to uniquely identify 
      // all enrolled users on your backend for example.
      console.log("Linked facial Id: " + userData.facialId)
      // Grab the arbitrary data you have already linked (if any) to this particular user
      // during his enrollment via the payload parameter of the enroll() method.
      console.log("Payload: " + JSON.stringify(userData.payload)) // {"whoami": 123456, "email": "john.doe@example.com"} from the enroll() example above
  }).catch(errCode => {
      handleError(errCode)
  })
}