Create an app registration

Endpoint:

POST - https://api.verifik.co/v2/app-registrations

An App Registration is an instance within Verifik's system that allows a user to initiate the authentication and validation process using specified project flows, email, and/or phone details. This process ensures the identity of the user and provides secure validation through various verification steps.

Headers

Include the necessary authentication headers, as well as any other headers required for authorization and content-type, such as:

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Body

• project - ObjectId - Required The unique ID of the project associated with this registration.

• projectFlow - ObjectId - Required The unique ID of the project flow that defines the registration and validation process.

• email - String - Optional The email address for the user to be registered. (Either email or phone is required).

• phone - String - Optional The phone number for the user to be registered. (Either email or phone is required).

• countryCode - String - Optional The country code associated with the phone number. Required if phone is provided.

• language - String - Optional The preferred language for communication during the registration process. Default: "en".

Minimal Body Data

{
  "project": "ObjectId('5f8d0a24c6345c001fa9e2b3')",
  "projectFlow": "ObjectId('5f8d0a24c6345c001fa9e2b4')",
  "email": "[e-mail]",
  "phone": "1234567890",
  "countryCode": "+1"
}

Full Body Data

{
  "project": "ObjectId('5f8d0a24c6345c001fa9e2b3')",
  "projectFlow": "ObjectId('5f8d0a24c6345c001fa9e2b4')",
  "email": "[e-mail]",
  "phone": "1234567890",
  "countryCode": "+1",
  "language": "es"
}

Request

cURL

curl -X POST https://api.verifik.co/v2/app-registrations \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
  "project": "5f8d0a24c6345c001fa9e2b3",
  "projectFlow": "5f8d0a24c6345c001fa9e2b4",
  "email": "[e-mail]",
  "phone": "1234567890",
  "countryCode": "+1",
  "language": "es"
}'

Node.js

const axios = require('axios');

const data = {
  project: "5f8d0a24c6345c001fa9e2b3",
  projectFlow: "5f8d0a24c6345c001fa9e2b4",
  email: "[e-mail]",
  phone: "1234567890",
  countryCode: "+1",
  version: 2,
  language: "es"
};

axios.post('https://api.verifik.co/v2/app-registrations', data, {
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json'
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.error(error.response ? error.response.data : error.message);
});

Kotlin

import android.os.AsyncTask
import java.io.OutputStream
import java.net.HttpURLConnection
import java.net.URL

fun createAppRegistration() {
    val url = URL("https://api.verifik.co/v2/app-registrations")
    val jsonBody = """
        {
          "project": "5f8d0a24c6345c001fa9e2b3",
          "projectFlow": "5f8d0a24c6345c001fa9e2b4",
          "email": "[e-mail]",
          "phone": "1234567890",
          "countryCode": "+1",
          "language": "es"
        }
    """.trimIndent()

    AsyncTask.execute {
        with(url.openConnection() as HttpURLConnection) {
            requestMethod = "POST"
            setRequestProperty("Authorization", "Bearer YOUR_ACCESS_TOKEN")
            setRequestProperty("Content-Type", "application/json")
            doOutput = true

            // Write JSON body to the request
            outputStream.use { os: OutputStream ->
                val input = jsonBody.toByteArray(Charsets.UTF_8)
                os.write(input, 0, input.size)
            }

            // Read the response
            val responseCode = responseCode
            if (responseCode == HttpURLConnection.HTTP_OK) {
                inputStream.bufferedReader().use {
                    val response = it.readText()
                    println("Response: $response")
                }
            } else {
                println("Request failed with code: $responseCode")
            }
        }
    }
}

Swift

import Foundation

func createAppRegistration() {
    let url = URL(string: "https://api.verifik.co/v2/app-registrations")!
    var request = URLRequest(url: url)
    request.httpMethod = "POST"
    request.setValue("Bearer YOUR_ACCESS_TOKEN", forHTTPHeaderField: "Authorization")
    request.setValue("application/json", forHTTPHeaderField: "Content-Type")

    // JSON body
    let jsonBody: [String: Any] = [
        "project": "5f8d0a24c6345c001fa9e2b3",
        "projectFlow": "5f8d0a24c6345c001fa9e2b4",
        "email": "[e-mail]",
        "phone": "1234567890",
        "countryCode": "+1",
        "language": "es"
    ]

    // Convert JSON to Data
    request.httpBody = try? JSONSerialization.data(withJSONObject: jsonBody, options: [])

    // Send request
    let task = URLSession.shared.dataTask(with: request) { data, response, error in
        if let error = error {
            print("Request error:", error)
            return
        }

        if let data = data, let responseString = String(data: data, encoding: .utf8) {
            print("Response data:", responseString)
        } else {
            print("Request failed with response: \(String(describing: response))")
        }
    }
    task.resume()
}

Response

The response will contain information about the new App Registration instance. Important fields include the unique identifier _id, the status of the registration process, and a token to verify the registration.

Example Successful Response

200

{
  "data": {
    "appRegistration": {
      "_id": "65772f3b427932d45a3811f9",
      "client": "5f8d0a24c6345c001fa9e2b2",
      "project": "5f8d0a24c6345c001fa9e2b3",
      "projectFlow": "5f8d0a24c6345c001fa9e2b4",
      "status": "STARTED",
      "email": "[e-mail]",
      "countryCode": "+1",
      "phone": "[phone]",
      "language": "es",
      "currentStep": 1,
      "createdAt": "2023-12-11T15:48:11.640Z",
      "updatedAt": "2023-12-11T15:48:11.640Z"
    },
    "informationValidation": {
      "_id": "65772f3b427932d45a3811fa"
    },
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  }
}

412

{
  "code": "PreconditionFailed",
  "message": "email domain not allowed"
}

{
  "code": "Conflict",
  "message": "email_is_registered_already"
}

422

{
  "code": "MissingParameter",
  "message": "missing project"
}

{
  "code": "MissingParameter",
  "message": "email domain not allowed"
}

{
  "code": "MissingParameter",
  "message": "missing countryCode"
}