numaxlab/cegal-client

Cliente PHP para la API de Cegal

dev-main 2025-12-03 07:43 UTC

Requires

• php: >=8.2
• ext-libxml: *
• ext-simplexml: *
• symfony/http-client: ^7.3

Requires (Dev)

• pestphp/pest: ^4.1

MIT

• Adrián P. Blunier

README

Cliente PHP para la API Cegal en Red que ofrece Cegal. La documentación completa de los endpoints disponibles puede consultarse en su documentación.

Instalación

Puedes instalar el paquete a través de Composer:

composer require numaxlab/cegal-client

Uso

Para usar el cliente, necesitas disponer de credenciales de acceso para Cegal en red.

use NumaxLab\Cegal\Client;

$client = Client::create('tu-usuario', 'tu-contraseña');

Obtener disponibilidad de libros por ISBN

Puedes obtener la disponibilidad en asociados de Cegal para uno o varios ISBNs.

$availabilityCollection = $client->getAvailability('978-84-9865-535-7');
$availability = $availabilityCollection->first();

echo $availability->sinliId;
echo $availability->name;
echo $availability->isDistributor();
echo $availability->isBookshop();

Obtener información de un libro por ISBN

Puedes obtener la información de un libro (o de varios) a partir de su ISBN.

// Para un único ISBN
$bookCollection = $client->getBookByIsbn('978-84-9865-535-7');
$book = $bookCollection->first();

echo $book->title;

// Para múltiples ISBNs
$bookCollection = $client->getBookByIsbn([
    '978-84-9865-535-7',
    '978-84-9182-325-4'
]);

foreach ($bookCollection as $book) {
    echo $book->title . "\n";
}

Testing

Para ejecutar los tests, usa el siguiente comando:

./vendor/bin/pest

Licencia

Este proyecto está bajo la licencia MIT. Para más detalles, consulta el archivo LICENSE.