API Usuarios V2

Crear Usuario

Mejora la gestión de tus clientes creando cuentas hijas desde tu cuenta distribuidora. Accede a una vista gráfica en el Portal SW > Clientes para supervisarlas fácilmente.

🔗 Endpoint

🔐 Autenticación y Headers

🧾 Parámetros JSON

Ejemplo Request

curl --location 'https://api.test.sw.com.mx/management/v2/api/dealers/users' \
--header 'Authorization: Bearer $token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Prueba Usuario V2",
    "taxId": "XIA190128J61",
    "email": "correo.example@gmail.com",
    "stamps": 10,
    "isUnlimited": false,
    "password": "SWpass1!",
    "notificationEmail":"correo.example@gmail.com",
    "phone": "0000000000"
}'

Ejemplo Response

{
    "data": {
        "idUser": "798299e2-0000-0000-91ce-00c1c7693807",
        "idDealer": "dec88317-0000-0000-9d23-9bb687444600",
        "name": "Prueba Usuario V2",
        "taxId": "XIA190128J61",
        "username": "correo.example@gmail.com",
        "lastPasswordChange": "2024-04-11T13:29:58.5576372",
        "email": "correo.example@gmail.com",
        "isAdmin": false,
        "profile": 3,
        "isActive": true,
        "registeredDate": "2024-04-11T13:29:58.5572504",
        "accessToken": null,
        "phone": "0000000000"
    },
    "meta": null,
    "links": null,
    "status": "success"
}

{
    "message": "El email 'correo.example@gmail.com' ya esta en uso.",
    "status": "error"
}

Consulta de Usuarios

Método que proporciona la funcionalidad de consultar una lista de usuarios asociados a un token enviado en la solicitud. Permite filtrar los resultados utilizando una variedad de atributos, lo que posibilita la búsqueda de usuarios con características específicas.

🔗 Endpoint

🔐 Autenticación y Headers

📍 Parámetros Query

Ejemplo Request

Ejemplo de request para obtener usuarios sin filtro.

curl --request GET 
--url 'https://api.test.sw.com.mx/management/v2/api/dealers/users' \
--header 'Authorization: Bearer $token'

curl --location 'http://api.test.sw.com.mx/management/v2/api/dealers/users?TaxId=XIA190128J63' \
--header 'Authorization: bearer $token'

curl --location 'http://api.test.sw.com.mx/management/v2/api/dealers/users?IdUser=a8b8881a-3456-481b-96b9-e02fd895f5be' \
--header 'Authorization: bearer $token'

curl --request GET 
--url 'https://api.test.sw.com.mx/management/v2/api/dealers/users?Email=correo@example.com&IsActive=true' \
--header 'Authorization: Bearer $token'

Ejemplo Response

{
    "data": [
        {
            "idUser": "7300db9e-70d3-0000-0000-d25620290282",
            "idDealer": "dec88317-0000-0000-9d23-9bb687444600",
            "name": "Pruebas User",
            "taxId": "XAXX010101000",
            "username": "correo@example.com",
            "lastPasswordChange": "2023-09-01T13:31:36.837",
            "email": "correo@example.com",
            "isAdmin": false,
            "profile": 3,
            "isActive": true,
            "registeredDate": "2023-09-01T13:31:38.483",
            "accessToken": null,
            "phone": null,
            "stamps": 91,
            "isUnlimited": false
        }
    ],
    "meta": {
        "page": 1,
        "perPage": 10,
        "pageCount": 1,
        "totalCount": 1,
        "totalPages": 1
    },
    "links": {
        "Self": "?page=1&perPage=10&email=correo@example.com&isActive=true",
        "First": "?page=1&perPage=10&email=correo@example.com&isActive=true",
        "End": "?page=1&perPage=10&email=correo@example.com&isActive=true"
    },
    "status": "success"
}

{
    "messageDetail": "Guid should contain 32 digits with 4 dashes (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).",
    "message": "An exception was thrown while attempting to evaluate a LINQ query parameter expression. See the inner exception for more information. To show additional information call 'DbContextOptionsBuilder.EnableSensitiveDataLogging'.",
    "status": "error"
}

Actualizar Usuario

Realiza la modificación de alguno de los datos de tus cuentas hijas por este método.

🔗 Endpoint

🔐 Autenticación y Headers

📍 Parámetros Path

🧾 Parámetros JSON

Ejemplo Request

curl --location --request PUT 'https://api.test.sw.com.mx/management/v2/api/dealers/users/798299e2-0000-0000-91ce-00c1c7693807' \
--header 'Authorization: bearer $token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": null,
    "taxId": null,
    "isUnlimited": false,
    "iduser":"798299e2-0000-0000-91ce-00c1c7693807",
    "notificationEmail":"correo.cambio@gmail.com",
    "phone": "3325115682"
}'

Ejemplo Response

{
    "data": "798299e2-0000-0000-91ce-00c1c7693807",
    "meta": null,
    "links": null,
    "status": "success"
}

{
    "message": "No es posible actualizar, los dato enviados son identicos a los actuales",
    "status": "error"
}

Eliminar Usuario

Deshabilita las cuentas de tus clientes que no necesites con este método.

🔗 Endpoint

🔐 Autenticación y Headers

📍 Parámetros Path

Ejemplo Request

curl --location --request DELETE 'https://api.test.sw.com.mx/management/v2/api/dealers/users/798299e2-0000-0000-91ce-00c1c7693807' \
--header 'Authorization: Bearer $token'

Ejemplo Response

Recibirás un HTTP Code 204 - No Content

{
    "message": "El usuario no se puede eliminar, tiene saldo de 6",
    "status": "error"
}