Verificar Cuenta

Verificar si existe una cuenta de cliente basada en email o número de teléfono.

Endpoint

GET /api/clients

Descripción

Este endpoint te permite verificar si existe una cuenta de cliente usando dirección de email o número de teléfono. No se requiere autenticación para esta verificación.

Parámetros

Parámetro	Tipo	Requerido	Descripción
email	string	No*	Email del cliente para verificación (requerido si no se proporciona teléfono)
countryCode	string	No*	Código de país (requerido si no se proporciona email)
phone	string	No*	Número de teléfono (requerido si no se proporciona email)
identificationMethod	string	No	Método de identificación utilizado (email o phone)

*Se debe proporcionar email O countryCode + phone

Respuesta

200 OK

{
  "data": {
    "exists": true,
    "client": {
      "id": "client_id",
      "name": "Nombre del Cliente",
      "email": "cliente@ejemplo.com"
    }
  }
}

400 Bad Request

{
  "validationError": "Se debe proporcionar email o countryCode + phone"
}

404 Not Found

{
  "validationError": "Cliente no encontrado"
}

Ejemplos

cURL

curl -X GET "https://api.zelf.world/api/clients?email=cliente@ejemplo.com"

Node.js

const axios = require('axios');

const config = {
  method: 'get',
  url: 'https://api.zelf.world/api/clients',
  params: {
    email: 'cliente@ejemplo.com'
  }
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Python

import requests

url = "https://api.zelf.world/api/clients"
params = {
    "email": "cliente@ejemplo.com"
}

response = requests.get(url, params=params)
print(response.json())

PHP

<?php
$url = "https://api.zelf.world/api/clients?email=cliente@ejemplo.com";

$context = stream_context_create([
    'http' => [
        'method' => 'GET'
    ]
]);

$result = file_get_contents($url, false, $context);
echo $result;
?>

Rust

use reqwest;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = reqwest::Client::new();
    
    let response = client
        .get("https://api.zelf.world/api/clients")
        .query(&[("email", "cliente@ejemplo.com")])
        .send()
        .await?;
    
    let body = response.text().await?;
    println!("{}", body);
    
    Ok(())
}

Notas

• Este endpoint no requiere autenticación
• Se debe proporcionar email O countryCode + phone
• Retorna información del cliente si la cuenta existe
• Útil para verificar el estado de la cuenta antes del registro o inicio de sesión