PHPackages                             esolutions/apiperudev - 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. [HTTP & Networking](/categories/http)
4. /
5. esolutions/apiperudev

ActiveLibrary[HTTP & Networking](/categories/http)

esolutions/apiperudev
=====================

HTTP client for apiconsulta.dev API (RUC, DNI, exchange rate)

v1.0.2(1mo ago)01proprietaryPHPPHP ^8.2

Since Jun 11Pushed 1mo agoCompare

[ Source](https://github.com/eriquegasparcarlos/esolutions-apiperudev)[ Packagist](https://packagist.org/packages/esolutions/apiperudev)[ RSS](/packages/esolutions-apiperudev/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (1)Versions (2)Used By (0)

esolutions/apiperudev
=====================

[](#esolutionsapiperudev)

Cliente HTTP para la API de [apiconsulta.dev](https://apiconsulta.dev). Consulta datos de RUC, DNI y tipo de cambio en tiempo real.

Instalación
-----------

[](#instalación)

```
composer require esolutions/apiperudev
```

Namespace
---------

[](#namespace)

```
Esolutions\ApiPeruDev\

```

---

Configuración
-------------

[](#configuración)

Agregar en `config/esolutions.php`:

```
'apiperudev' => [
    'url'   => env('APIPERUDEV_URL', 'https://my.apiconsulta.dev/api'),
    'token' => env('APIPERUDEV_TOKEN'),
],
```

Agregar en `.env`:

```
APIPERUDEV_URL=https://my.apiconsulta.dev/api
APIPERUDEV_TOKEN=tu_token_aqui
```

---

Uso
---

[](#uso)

```
use Esolutions\ApiPeruDev\Service as ApiPeruDev;
```

### Buscar por RUC

[](#buscar-por-ruc)

```
$result = ApiPeruDev::searchWithInput('ruc', '20100070970');

// Respuesta exitosa:
// [
//     'success' => true,
//     'data' => [
//         'razon_social' => 'EMPRESA SAC',
//         'direccion'    => 'AV. LIMA 123',
//         'ubigeo'       => '150101',
//         ...
//     ]
// ]

// Respuesta fallida:
// ['success' => false, 'message' => 'RUC no encontrado']
```

### Buscar por DNI

[](#buscar-por-dni)

```
$result = ApiPeruDev::searchWithInput('dni', '12345678');

// Respuesta exitosa:
// [
//     'success' => true,
//     'data' => [
//         'nombres'           => 'JUAN',
//         'apellido_paterno'  => 'PÉREZ',
//         'apellido_materno'  => 'GARCÍA',
//         ...
//     ]
// ]
```

### Tipo de cambio

[](#tipo-de-cambio)

```
$result = ApiPeruDev::searchExchangeRateSaleWithInput('2026-05-13');

// Respuesta exitosa:
// [
//     'success' => true,
//     'data' => [
//         'venta'  => 3.72,
//         'compra' => 3.70,
//         'fecha'  => '2026-05-13'
//     ]
// ]
```

---

Métodos
-------

[](#métodos)

MétodoParámetrosDescripción`searchWithInput($type, $number)``string, string`Consulta RUC o DNI. `$type`: `'ruc'` o `'dni'``searchExchangeRateSaleWithInput($date)``string` (formato `Y-m-d`)Tipo de cambio para una fecha`searchRuc(Request $request)``Request`Endpoint de controlador — lee `number` del request`searchDni(Request $request)``Request`Endpoint de controlador — lee `number` del request---

Comportamiento de red
---------------------

[](#comportamiento-de-red)

ParámetroValorTimeout de conexión5 segundosTimeout de respuesta10 segundosSSL verifyDesactivado (compatible con entornos locales)Autenticación`Authorization: Bearer {token}`Todos los métodos retornan `array`. Los errores de red se capturan internamente — nunca lanza excepciones al llamador.

---

Uso como endpoint de controlador
--------------------------------

[](#uso-como-endpoint-de-controlador)

Si se necesita exponer la búsqueda como ruta API propia del proyecto:

```
// routes/api.php
use Esolutions\ApiPeruDev\Service as ApiPeruDev;

Route::post('/search-ruc', [ApiPeruDev::class, 'searchRuc']);
Route::post('/search-dni', [ApiPeruDev::class, 'searchDni']);
```

```
POST /api/search-ruc
{ "number": "20100070970" }
```

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance90

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity46

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

Unknown

Total

1

Last Release

46d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/57302658?v=4)[eriquegasparcarlos](/maintainers/eriquegasparcarlos)[@eriquegasparcarlos](https://github.com/eriquegasparcarlos)

---

Top Contributors

[![eriquegasparcarlos](https://avatars.githubusercontent.com/u/57302658?v=4)](https://github.com/eriquegasparcarlos "eriquegasparcarlos (9 commits)")

### Embed Badge

![Health badge](/badges/esolutions-apiperudev/health.svg)

```
[![Health](https://phpackages.com/badges/esolutions-apiperudev/health.svg)](https://phpackages.com/packages/esolutions-apiperudev)
```

###  Alternatives

[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[lomkit/laravel-rest-api

A package to build quick and robust rest api for the Laravel framework.

59463.6k](/packages/lomkit-laravel-rest-api)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135224.7k8](/packages/statamic-rad-pack-runway)[wirechat/wirechat

A Laravel Livewire messaging app for teams with private chats and group conversations.

56910.5k](/packages/wirechat-wirechat)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3518.3k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

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