solinte-net/sdk-php

SDK oficial de Solinte para PHP

dev-master 2025-06-30 16:23 UTC

Requires

• guzzlehttp/guzzle: ^7.9
• guzzlehttp/oauth-subscriber: ^0.8.1
• league/oauth2-client: ^2.8

Requires (Dev)

• phpunit/phpunit: ^11.5

MIT

• Marcos Muñoz

README

SDK de Solinte para PHP

SDK oficial de Solinte para PHP que permite integrar fácilmente la plataforma de trabajo contable de Solinte en tus aplicaciones.

💡 Requisitos

• PHP 8.0 o superior
• Composer
• Cuenta de desarrollador en Solinte

💻 Instalación

composer require solinte-net/sdk-php

¡Así de simple!

🛠️ Configuración

Para comenzar a usar el SDK, necesitas obtener las credenciales de tu aplicación desde el soporte de Solinte. Para más información podés consultar documentación de la API.

use Solinte\SdkPhp\Client;

$client = new Client([
    'client_id' => 'tu_client_id',
    'client_secret' => 'tu_client_secret',
    'redirect_uri' => 'tu_redirect_uri'
]);

🔑 Autenticación OAuth 2.0

El SDK utiliza OAuth 2.0 para la autenticación. Necesitarás implementar el flujo de autorización:

1. Redirigir al usuario a la página de autorización
2. Obtener el código de autorización
3. Intercambiar el código por un access_token

// URL de autorización
$authUrl = $client->getAuthorizationUrl([
    'scope' => 'basic perfil roles'
]);

// Después de la autorización, intercambiar el código por token
$token = $client->exchangeCodeForToken($code);

🤓 Uso Básico

Obtener información del usuario

// Obtener email del usuario
$email = $client->usuario()->email()->get();

// Obtener perfil completo del usuario
$perfil = $client->usuario()->perfil()->get();

Obtener roles del usuario

// Listar todos los roles del usuario
$roles = $client->usuario()->roles()->get();

// Obtener saldo de un rol específico
$saldo = $client->usuario()->roles()->saldo($rid, 'hoy');
// o con fecha específica
$saldo = $client->usuario()->roles()->saldo($rid, '2024-01-15');

📍 Scopes Disponibles

• basic - Solo lectura, acceso básico a /usuario
• perfil - Solo lectura, acceso al perfil completo del usuario
• roles - Solo lectura, acceso al listado de roles del usuario
• admin_rol - Lectura, creación y modificación de roles
• contactos - Solo lectura, acceso a contactos del usuario
• admin_contacto - Lectura, creación y modificación de contactos
• mensajes - Solo lectura, acceso a mensajes y comunicaciones
• admin_mensaje - Lectura, creación y modificación de mensajes

❌ Manejo de Errores

try {
    $perfil = $client->usuario()->perfil()->get();
} catch (Solinte\SdkPhp\Exceptions\ApiException $e) {
    echo "Error de API: " . $e->getMessage();
} catch (Solinte\SdkPhp\Exceptions\OAuthException $e) {
    echo "Error de autenticación: " . $e->getMessage();
}

📚 Documentación de la API

Para más información sobre los endpoints disponibles, podés consultar la documentación oficial de Solinte.

🤗 Colección de Postman

Podés probar la API directamente visitando nuestra colección de Postman.

❤️ Soporte

Para soporte técnico, podés contactarnos a través de la página de soporte.

⚖️ Licencia

MIT license. Copyright (c) 2025 - Solinte (SOLSOFT SOLUCIONES INTEGRALES S.A.)
Para más información, verifique el archivo LICENSE.