Actualizar un proyecto

Endpoint

PUT https://api.verifik.co/v3/projects/{id}

Actualiza la configuración de un proyecto usando un enfoque paso a paso (wizard). Soporta actualizaciones parciales.

Encabezados

Nombre	Valor
Content-Type	application/json
Authorization	Bearer <token>

Parámetros

Nombre	Tipo	Requerido	Descripción
id	string	Sí	Identificador único del proyecto

Solicitud

Node.js

const fetch = require("node-fetch");

async function run() {
  const projectId = "64a1b2c3d4e5f6789012345";
  const res = await fetch(`https://api.verifik.co/v3/projects/${projectId}`, {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
    },
    body: JSON.stringify({
      name: "Updated Project Name",
      allowedCountries: ["United States", "Canada"],
      dataProtection: {
        name: "Updated DPO",
        email: "updated-dpo@example.com",
        address: "789 New St",
        city: "Toronto",
        country: "Canada",
        postalCode: "M5H 2N2"
      }
    }),
  });
  console.log(await res.json());
}

run();

PHP

<?php
$projectId = "64a1b2c3d4e5f6789012345";
$ch = curl_init("https://api.verifik.co/v3/projects/" . $projectId);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
$body = json_encode([
    "name" => "Updated Project Name",
    "allowedCountries" => ["United States", "Canada"],
    "dataProtection" => [
        "name" => "Updated DPO",
        "email" => "updated-dpo@example.com",
        "address" => "789 New St",
        "city" => "Toronto",
        "country" => "Canada",
        "postalCode" => "M5H 2N2"
    ]
]);
curl_setopt($ch, CURLOPT_POSTFIELDS, $body);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

project_id = "64a1b2c3d4e5f6789012345"
url = f"https://api.verifik.co/v3/projects/{project_id}"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
payload = {
    "name": "Updated Project Name",
    "allowedCountries": ["United States", "Canada"],
    "dataProtection": {
        "name": "Updated DPO",
        "email": "updated-dpo@example.com",
        "address": "789 New St",
        "city": "Toronto",
        "country": "Canada",
        "postalCode": "M5H 2N2"
    }
}
r = requests.put(url, json=payload, headers=headers)
print(r.json())

Go

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    projectId := "64a1b2c3d4e5f6789012345"
    payload := map[string]interface{}{
        "name": "Updated Project Name",
        "allowedCountries": []string{"United States", "Canada"},
        "dataProtection": map[string]string{
            "name": "Updated DPO",
            "email": "updated-dpo@example.com",
            "address": "789 New St",
            "city": "Toronto",
            "country": "Canada",
            "postalCode": "M5H 2N2",
        },
    }
    b, _ := json.Marshal(payload)
    url := fmt.Sprintf("https://api.verifik.co/v3/projects/%s", projectId)
    req, _ := http.NewRequest("PUT", url, bytes.NewBuffer(b))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    var out map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&out)
    fmt.Println(out)
}

Respuesta

200

{
    "data": {
        "_id": "64a1b2c3d4e5f6789012345",
        "name": "Updated Project Name",
        "identifier": null,
        "contactEmail": "new-admin@example.com",
        "privacyUrl": "https://example.com/privacy",
        "termsAndConditionsUrl": "https://example.com/terms",
        "status": "draft",
        "currentStep": 6,
        "lastStep": 6,
        "demoMode": false,
        "demoOTP": null,
        "allowedCountries": ["United States", "Canada", "Mexico"],
        "dataProtection": {
            "name": "Updated DPO",
            "email": "updated-dpo@example.com",
            "address": "789 New St",
            "address2": "",
            "city": "Toronto",
            "country": "Canada",
            "postalCode": "M5H 2N2"
        },
        "branding": {
            "bgColor": "#1a365d",
            "tabColor": "#01236D",
            "borderColor": "#B2BDD3",
            "buttonColor": "#3182ce",
            "buttonTxtColor": "#ffffff",
            "secondaryButtonColor": "#B2BDD3",
            "secondaryButtonTextColor": "#FFFFFF",
            "txtColor": "#8091B6",
            "titleColor": "#1a202c",
            "logo": "https://example.com/logo.png",
            "rightImage": null,
            "rightImagePosition": "center center",
            "rightBackgroundColor": "white"
        },
        "projectFlows": "64a1b2c3d4e5f6789012346",
        "version": 2,
        "createdAt": "2023-07-01T10:00:00.000Z",
        "updatedAt": "2023-07-01T16:45:00.000Z"
    },
    "status": "completed"
}

400

{
    "message": "Invalid project ID format",
    "code": "BadRequest",
    "status": 400,
    "timestamp": "2023-07-01T10:00:00.000Z"
}

401/403

{
    "message": "Access forbidden",
    "code": "Forbidden",
    "status": 401,
    "timestamp": "2023-07-01T10:00:00.000Z"
}

o

{
    "message": "Access forbidden",
    "code": "Forbidden",
    "status": 403,
    "timestamp": "2023-07-01T10:00:00.000Z"
}

404

{
    "message": "Project not found",
    "code": "NotFound",
    "status": 404,
    "timestamp": "2023-07-01T10:00:00.000Z"
}

409

{
    "message": "Country not supported. contact support to help you include your country to our list.",
    "code": "MissingParameter",
    "status": 409,
    "timestamp": "2023-07-01T10:00:00.000Z"
}

422

{
    "message": "Project flow validation failed",
    "code": "UnprocessableEntity",
    "status": 422,
    "timestamp": "2023-07-01T10:00:00.000Z",
    "details": [
        {
            "field": "projectFlow.documents.verificationMethods",
            "message": "verificationMethods is required when documents step is not skipped"
        }
    ]
}

Notas

• Actualizaciones parciales: sólo se actualizan los campos enviados.
• Creación de flujo: si se envían campos de projectFlow y no existe, se crea automáticamente.
• Validación: campos de projectFlow se validan en conjunto para consistencia.
• steps.document y steps.liveness: mandatory, optional o skip.
• Métodos de verificación: requeridos cuando steps.document != skip.