README

Cliente HTTP para la API de apiconsulta.dev. Consulta datos de RUC, DNI y tipo de cambio en tiempo real.

Instalación

composer require esolutions/apiperudev

Namespace

Esolutions\ApiPeruDev\

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

use Esolutions\ApiPeruDev\Service as ApiPeruDev;

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

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

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

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

Comportamiento de red

Todos los métodos retornan array. Los errores de red se capturan internamente — nunca lanza excepciones al llamador.

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" }