> For the complete documentation index, see [llms.txt](https://dev-cucei-itrans.gitbook.io/siiau-api-client/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev-cucei-itrans.gitbook.io/siiau-api-client/requests/usuario.md).

# Usuario

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

<table><thead><tr><th width="188.33333333333331">Parametro</th><th width="194">Tipo</th><th>Descripción</th></tr></thead><tbody><tr><td><strong>codigo</strong></td><td><code>string</code></td><td>Código de usuario</td></tr></tbody></table>

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

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

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

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

{% endtab %}

{% tab title="Facade" %}

<pre class="language-php"><code class="lang-php"><strong>use Siiau\ApiClient\Facades\Siiau;
</strong>
$usuario = Siiau::usuario()->encontrar(
    codigo: '123456789',
);
</code></pre>

{% endtab %}

{% tab title="Injection" %}

```php
use Siiau\ApiClient\SiiauConnector;

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

{% endtab %}
{% endtabs %}

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

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

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

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

{% endtab %}

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

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

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

$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/datos-usuario

> Obtiene información básica de un usuario.

```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/datos-usuario":{"post":{"tags":["Usuarios"],"summary":"Obtiene información básica de un usuario.","operationId":"7541b3cc72e517751c1d1a8cd9836ced","parameters":[{"name":"codigo","in":"query","description":"Código de SIIAU del Usuario","required":true}],"responses":{"200":{"description":"Json con información general de un usuario, sea alumno o trabajador.","content":{"application/json":{"schema":{"properties":{"localidad":{"type":"string"},"edo_civil":{"type":"string"},"giro_empresa":{"type":"string"},"domicilio":{"type":"string"},"telefono":{"type":"string"},"ap_materno":{"type":"string"},"loc_nac":{"type":"string"},"nom_empresa":{"type":"string"},"imss":{"type":"string"},"colonia":{"type":"string"},"rfc":{"type":"string"},"tipo_sangre":{"type":"string"},"codigo":{"type":"string"},"nombre":{"type":"string"},"genero":{"type":"string"},"cp":{"type":"string"},"no_interior":{"type":"string"},"email":{"type":"string"},"tel_empresa":{"type":"string"},"fecha_nac":{"type":"string"},"no_exterior":{"type":"string"},"migratoria":{"type":"string"},"curp":{"type":"string"},"pais_nac":{"type":"string"},"nacionalidad":{"type":"string"},"ap_paterno":{"type":"string"},"pidm":{"type":"string"}},"type":"object"}}}},"404":{"description":"Error: Not Found","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"}}}}}}}}}
```