PHPackages                             uspdev/cadastros-auxiliares-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. uspdev/cadastros-auxiliares-client

ActiveLibrary[API Development](/categories/api)

uspdev/cadastros-auxiliares-client
==================================

Laravel client for cadastros-auxiliares webservice endpoints

1.0.3(2mo ago)0136—7.5%31MITPHPPHP ^8.2

Since Mar 9Pushed 2mo agoCompare

[ Source](https://github.com/uspdev/cadastros-auxiliares-client)[ Packagist](https://packagist.org/packages/uspdev/cadastros-auxiliares-client)[ RSS](/packages/uspdev-cadastros-auxiliares-client/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (4)Dependencies (6)Versions (5)Used By (1)

Cadastros auxiliares client
===========================

[](#cadastros-auxiliares-client)

Cliente Laravel para consumo dos endpoints do `cadastros-auxiliares`.

Objetivo
--------

[](#objetivo)

Centralizar no backend dos sistemas locais:

- requisições HTTP para mensagens (opcional), programas e cursos de graduação;
- comportamento fail-silent (sem quebrar interface).

Endpoints disponíveis no serviço
--------------------------------

[](#endpoints-disponíveis-no-serviço)

O client consome, por padrão, estes endpoints a partir de `CADASTROS_AUXILIARES_URL`:

- `GET /api/mensagens`
- `GET /api/pos/programas`
- `GET /api/pos/programas/{codcur}`
- `GET /api/graduacao/cursos`
- `GET /api/graduacao/cursos/{codcur}`

Configuração (`.env`)
---------------------

[](#configuração-env)

```
CADASTROS_AUXILIARES_URL=https://cadastros-auxiliares.seu-dominio

# Opcional: ativa/desativa consumo de mensagens
CADASTROS_AUXILIARES_MENSAGENS_INTEGRACAO=true

# Obrigatória: a mesma senha configurada no cadastros-auxiliares
CADASTROS_AUXILIARES_PASSWORD=

CADASTROS_AUXILIARES_SISTEMA_NAME=ponto
CADASTROS_AUXILIARES_MENSAGENS_LIMITE=5
CADASTROS_AUXILIARES_MENSAGENS_TIMEOUT=0
CADASTROS_AUXILIARES_MENSAGENS_REFRESH=30
```

Observações:

- a integração de mensagens é opcional (`CADASTROS_AUXILIARES_MENSAGENS_INTEGRACAO`);
- os clientes de programas e cursos de graduação ficam disponíveis por padrão após instalar a biblioteca (sem flag dedicada);
- para casos especiais, ainda é possível sobrescrever endpoint por config (`mensagens.endpoint_url` e `programas.endpoint_url`).

Uso básico - mensagens
----------------------

[](#uso-básico---mensagens)

```
use Uspdev\CadastrosAuxiliaresClient\Contracts\MensagensClientInterface;

$mensagens = app(MensagensClientInterface::class)->fetch([
    'sistema' => 'ponto',
    'publico' => auth()->check() ? 'usuario' : true,
    'ativos' => true,
    'limite' => 5,
]);
```

Retorno: `Collection` de mensagens (arrays do payload JSON).

Uso básico - programas
----------------------

[](#uso-básico---programas)

```
use Uspdev\CadastrosAuxiliaresClient\Contracts\ProgramasClientInterface;

$programas = app(ProgramasClientInterface::class)->listar();
$programa = app(ProgramasClientInterface::class)->obter(1001);
```

Retornos:

- `listar()`: `Collection` de programas (`id`, `codcur`, `nomcur`, `codslg`);
- `obter($codcur)`: `array|null` com os dados do programa.

Uso básico - cursos de graduação
--------------------------------

[](#uso-básico---cursos-de-graduação)

```
use Uspdev\CadastrosAuxiliaresClient\Contracts\CursosGraduacaoClientInterface;

$cursos = app(CursosGraduacaoClientInterface::class)->listar();
$curso = app(CursosGraduacaoClientInterface::class)->obter(1234);
```

Retornos:

- `listar()`: `Collection` de cursos (`id`, `codcur`, `nomcur`, `codset`, `nomset`, `nomabvset`);
- `obter($codcur)`: `array|null` com os dados do curso.

Passos para implementar em sistemas locais
------------------------------------------

[](#passos-para-implementar-em-sistemas-locais)

1. Adicionar dependência do client no sistema.
2. Configurar variáveis `CADASTROS_AUXILIARES_*` no `.env`.
3. Garantir que os endpoints estejam acessíveis pelo backend do sistema.
4. Se usar `laravel-usp-theme`, atualizar o tema para versão com suporte ao client.
5. Limpar cache/config (`php artisan optimize:clear`).

###  Health Score

42

—

FairBetter than 89% of packages

Maintenance83

Actively maintained with recent releases

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~8 days

Total

4

Last Release

85d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8a59480189a3ba1aa8355cb434880695569433f5d1c9e375e8238d5ff1a56beb?d=identicon)[uspdev](/maintainers/uspdev)

---

Top Contributors

[![alecostaweb](https://avatars.githubusercontent.com/u/10613364?v=4)](https://github.com/alecostaweb "alecostaweb (7 commits)")

### Embed Badge

![Health badge](/badges/uspdev-cadastros-auxiliares-client/health.svg)

```
[![Health](https://phpackages.com/badges/uspdev-cadastros-auxiliares-client/health.svg)](https://phpackages.com/packages/uspdev-cadastros-auxiliares-client)
```

###  Alternatives

[spatie/laravel-responsecache

Speed up a Laravel application by caching the entire response

2.8k8.7M64](/packages/spatie-laravel-responsecache)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.1M337](/packages/psalm-plugin-laravel)[defstudio/telegraph

A laravel facade to interact with Telegram Bots

815320.5k3](/packages/defstudio-telegraph)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[jasara/php-amzn-selling-partner-api

A fluent interface for Amazon's Selling Partner API in PHP

1348.1k1](/packages/jasara-php-amzn-selling-partner-api)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)