# Validar Credenciales

## <mark style="color:red;">Parámetros</mark>

<table><thead><tr><th>Parámetro</th><th width="249.33333333333331">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>codigo</strong></td><td><code>string</code></td><td>Código del usuario</td></tr><tr><td><strong>password</strong></td><td><code>string</code></td><td>Contraseña del usuario</td></tr></tbody></table>

## <mark style="color:red;">Uso</mark>

### <mark style="color:orange;">Básico</mark>

{% tabs %}
{% tab title="Helper" %}

```php
$credencialesValidas = siiau()->usuario()->credencialesValidas(
    codigo: '123456789',
    password: 'pipipopo'
);
```

{% endtab %}

{% tab title="Facade" %}

```php
use Siiau\ApiClient\Facades\Siiau;

$credencialesValidas = Siiau::usuario()->validarCredenciales(
    codigo: '123456789',
    password: 'pipipopo'
);
```

{% endtab %}

{% tab title="Injection" %}

```php
use Siiau\ApiClient\SiiauConnector;

public function foo(SiiauConnector $siiau): void
{
    $credencialesValidas = $siiau->usuario()->validarCredenciales(
        codigo: '123456789',
        password: 'pipipopo'
    );
}
```

{% endtab %}
{% endtabs %}

### <mark style="color:orange;">Avanzado</mark>

{% tabs %}
{% tab title="Por sync request" %}

```php
use Siiau\ApiClient\Requests\ValidarCredencialesRequest;

$response = siiau()->send(new ValidarCredencialesRequest(
    codigo: '123456789',
    password: 'pipipopo',
));
```

{% endtab %}

{% tab title="Por async request" %}

```php
use Siiau\ApiClient\Requests\ValidarCredencialesRequest;

$promise = siiau()->sendAsync(new ValidarCredencialesRequest(
    codigo: '123456789',
    password: 'pipipopo',
));

$promise
    ->then(static function (Response $response): void {
        // Handle Response
    })
    ->otherwise(static function (RequestException $exception): void {
        // Handle Exception
    });
```

{% endtab %}
{% endtabs %}

***

## <mark style="color:red;">API</mark>

## POST /api/validar-credenciales

> Verifica que credenciales de SIIAU sean válidas y correctas. Utilizada para implementar login en sistemas.

```json
{"openapi":"3.0.0","info":{"title":"Documentación de APIs de consulta al WebServer de SIIAU","version":"1.0.0"},"tags":[{"name":"Usuarios","description":"API Endpoints para manejo de Usuarios en general"}],"servers":[{"url":"https://ws.itrans.cucei.udg.mx","description":"API Server"}],"security":[{"JWT":[]}],"components":{"securitySchemes":{"JWT":{"type":"apiKey","description":"Ingrese un Token con el formato: (Bearer \\<token\\>). Ejemplo: Bearer qwerty123456","name":"Authorization","in":"header"}}},"paths":{"/api/validar-credenciales":{"post":{"tags":["Usuarios"],"summary":"Verifica que credenciales de SIIAU sean válidas y correctas. Utilizada para implementar login en sistemas.","operationId":"982633e72f7ba16c00365dea673b765e","parameters":[{"name":"codigo","in":"query","description":"Código de SIIAU","required":true},{"name":"password","in":"query","description":"Contraseña de SIIAU","required":true}],"responses":{"200":{"description":"Respuesta de validación de credenciales exitosa. Devuelve un ''true'' como string","content":{"application/json":{"schema":{"description":"Valor de conexión Exitosa","type":"string","nullable":"false"}}}},"403":{"description":"Error: Forbidden","content":{"application/json":{"schema":{"properties":{"error":{"description":"Descripción del error","type":"string","nullable":"false"}},"type":"object"}}}},"500":{"description":"Error: response status is 500","content":{"application/json":{"schema":{"properties":{"error":{"description":"Descripción del error","type":"string","nullable":"false"}},"type":"object"}}}}}}}}}
```