Create an app registration (Crear un registro en la app)

Endpoint:

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

Un App Registration es una instancia dentro del sistema de Verifik que permite a un usuario iniciar el proceso de autenticación y validación utilizando flujos de proyectos específicos, junto con detalles de correo electrónico y/o teléfono. Este proceso garantiza la identidad del usuario y proporciona una validación segura a través de varios pasos de verificación.

Encabezados (Headers)

Incluye los encabezados de autenticación necesarios, así como otros requeridos para la autorización y el tipo de contenido, tales como:

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

Body

• project - ObjectId - Requerido ID único del proyecto asociado con este registro.

• projectFlow - ObjectId - Requerido ID único del Project Flow que define el proceso de registro y validación.

• email - String - Opcional Dirección de correo electrónico del usuario a registrar. (Se requiere al menos email o phone).

• phone - String - Opcional Número de teléfono del usuario a registrar. (Se requiere al menos phone o email).

• countryCode - String - Opcional Código de país asociado con el número de teléfono. (Obligatorio si se proporciona un teléfono).

• language - String - Opcional Idioma preferido para la comunicación durante el proceso de registro.

• Valor por defecto: "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()
}

Respuesta

La respuesta contendrá información sobre la nueva instancia de App Registration. Los campos importantes incluyen _id: Identificador único de la instancia de registro, status: Estado del proceso de registro. token para verificar el registro.

Ejemplo de Respuesta Exitosa

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