Para comenzar a usar la API de Soldo Business en tu cuenta de producción, deberás crear una aplicación en la aplicación web de Soldo. Este proceso generará las credenciales que tu sistema utilizará para autenticarse de forma segura con la API.
Crear una aplicación
- Inicia sesión en la aplicación web de Soldo.
- Desde el menú de navegación principal, ve a Integraciones > Business API.
- Selecciona Crear aplicación.
- Introduce un nombre para tu aplicación.
- Introduce una clave pública. Deberás generar un par de claves RSA de 2048 bits en formato PEM.
¿Qué es un par de claves?
- Clave pública: Se comparte con Soldo. Piénsalo como un nombre de usuario: identifica tu aplicación.
- Clave privada: Se mantiene en secreto. Se utiliza para firmar de forma segura tus solicitudes de API.
Puedes encontrar instrucciones para crear un par de claves utilizando openssl durante el flujo de configuración.
- Selecciona Siguiente.
- Selecciona los alcances que tu aplicación necesita y luego haz clic en Continuar. Puedes editarlos más adelante si es necesario.
- Revisa tu configuración y acepta los términos y condiciones.
- Selecciona Crear aplicación
Una vez creada, tus credenciales se mostrarán en una ventana emergente:
- ID de cliente – identifica tu aplicación
- Secreto de cliente – se utiliza para la autenticación estándar
- Token de huella digital – se utiliza para autenticación avanzada o para descargar archivos adjuntos
¿Qué sucede si pierdo mis credenciales de API?
Puedes regenerarlas en cualquier momento. Ve a Integraciones > Business API, selecciona la aplicación y haz clic en Regenerar credenciales. Esto generará un nuevo secreto de cliente y token de huella digital. Tu ID de cliente permanecerá igual.
Próximos pasos
Una vez que hayas creado tu aplicación en la aplicación web y generado tus credenciales, ya estás listo para comenzar a usar la API de Soldo Business.
La documentación completa de la API se encuentra en nuestro Portal para Desarrolladores de Business API.