Documentación de la API GetClient ID/DNI/CUIT de WHMCS para obtener datos del cliente

Descripción

Esta API permite obtener la información de un cliente en WHMCS utilizando su ID de cliente o su DNI/CUIT.

URL de la API

Método

Parámetros de la solicitud

Los parámetros que deben enviarse en la solicitud son:

• action (obligatorio): Define la acción a ejecutar. En este caso, el valor debe ser "getclientdnicuit".
• clientid_dni_cuit (obligatorio): Uno de estos dos parámetros debe enviarse para buscar al cliente.
• identifier (obligatorio): El identificador que autentica la solicitud.
• secret (obligatorio): La clave secreta que autentica la solicitud.
• responsetype (opcional): Define el formato de la respuesta. El valor debe ser "json".

Ejemplo de solicitud

Para obtener los datos del cliente utilizando su clientid_dni_cuit, la solicitud debe enviarse de la siguiente manera:

POST /includes/api.php HTTP/1.1
Host: clientes.latincloud.com
Content-Type: application/x-www-form-urlencoded

action=getclientdnicuit&clientid_dni_cuit=27725&identifier=TU_IDENTIFIER&secret=TU_SECRET&responsetype=json
        

Respuesta de la API

La respuesta de la API será un objeto JSON con la siguiente estructura:

• result: Indica el resultado de la solicitud (success o error).
• totalresults: Número de resultados devueltos.
• clients: Lista de clientes que coinciden con los parámetros de búsqueda.

Ejemplo de respuesta.

        {
            "result": "success",
            "totalresults": 1,
            "clients": [
                {
                    "client_id": 27725,
                    "firstname": "Sergio",
                    "lastname": "Rios",
                    "email": "srios@latincloud.com"
                }
            ]
        }
        

La busqueda puede ser por id de cliente dni o cuit ingresando como parametro en clientid_dni_cuit

Errores comunes

• Si no se proporciona un clientid_dni_cuit, la API devolverá un error indicando que falta un parámetro requerido.
• Si la autenticación falla (por un identifier o secret incorrectos), se retornará un error de autenticación.