API de Revendedores para SQL Server
Gestione su cuenta de revendedor con nuestra API para SQL Server de forma sencilla y segura. Pruebe gratis nuestra API para SQL Server. Nuestro equipo le ayudará a gestionar los clientes de su cuente revendedor en SQL Server.
Funcionalidad de la API a Revendedores
Añadir una subcuenta con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'subaccount';
DECLARE @method varchar(500) = 'addsubaccount';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @accountemail varchar(500) = 'email@email.com';
DECLARE @accountpassword varchar(500) = 'password';
DECLARE @namelastname varchar(500) = 'name+lastname';
DECLARE @iscompany varchar(500) = '1';
DECLARE @companyname varchar(500) = 'mycompany';
DECLARE @documentid varchar(500) = '123456789A';
DECLARE @language varchar(500) = 'en';
DECLARE @countrycode varchar(500) = 'us';
DECLARE @cityid varchar(500) = '1';
DECLARE @cityname varchar(500) = 'town';
DECLARE @zipcode varchar(500) = '123456';
DECLARE @address varchar(500) = 'address';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&accountemail='+@accountemail+'&accountpassword='+@accountpassword+'&namelastname='+@namelastname+'&iscompany='+@iscompany+'&companyname='+@companyname+'&documentid='+@documentid+'&language='+@language+'&countrycode='+@countrycode+'&cityid='+@cityid+'&cityname='+@cityname+'&zipcode='+@zipcode+'&address='+@address;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win| Parámetro | Descripción | Obligatorio / Opcional |
|---|---|---|
| class=subaccount | Clase a la que se realiza la petición | Obligatorio |
| method=addsubaccount | Método de la clase al que se realiza la petición | Obligatorio |
| user | El usuario / email de su cuenta de Afilnet | Obligatorio |
| password | El password de su cuenta de Afilnet | Obligatorio |
| accountemail | Email de la cuenta | Obligatorio |
| accountpassword | Password de la cuenta | Obligatorio |
| namelastname | Nombre y apellidos de la persona de contacto | Obligatorio |
| iscompany | (0) Si es una persona física o (1) si es una empresa | Obligatorio |
| companyname | Nombre de la empresa (en caso de que sea empresa) | Opcional |
| documentid | Código del documento de identificación de la empresa | Obligatorio |
| language | Idioma de la subcuenta. Ver tabla adjunta | Obligatorio |
| countrycode | Código ISO del país en formato ISO-3166-1 ALPHA-2 | Obligatorio |
| cityid | Identificador de la ciudad | Obligatorio |
| cityname | Nombre de la ciudad o pueblo al que pertenece | Obligatorio |
| zipcode | Código postal | Obligatorio |
| address | Dirección fisica | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
| Código | Descripción |
|---|---|
| MISSING_USER | Usuario / email no incluido |
| MISSING_PASSWORD | Password no incluido |
| MISSING_CLASS | Clase no incluida |
| MISSING_METHOD | Método no incluido |
| MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
| INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
| INCORRECT_CLASS | Clase incorrecta |
| INCORRECT_METHOD | Método incorrecto |
| EMPTY_COUNTRYCODE | El código del país está vacío |
| EMPTY_FIELDS | Algún campo obligatorio está vacío |
| COUNTRY_NOT_FOUND | No existe ningún país con el código indicado |
| EMPTY_CITY | No ha indicado la ciudad |
| CITY_NOT_FOUND | La ciudad indicada no existe |
| INCORRECT_EMAIL | El email incluido no es válido |
| INCORRECT_PASSWORD | El password incluido no es válido |
| RESELLER_ACCOUNT_REQUIRED | La cuenta del usuario no tiene activo el plan revendedor |
Modificar una subcuenta con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'subaccount';
DECLARE @method varchar(500) = 'modifysubaccount';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @accountemail varchar(500) = 'email@email.com';
DECLARE @modifypassword varchar(500) = '1';
DECLARE @accountpassword varchar(500) = 'password';
DECLARE @namelastname varchar(500) = 'name+lastname';
DECLARE @iscompany varchar(500) = '1';
DECLARE @companyname varchar(500) = 'mycompany';
DECLARE @documentid varchar(500) = '123456789A';
DECLARE @language varchar(500) = 'en';
DECLARE @countrycode varchar(500) = 'us';
DECLARE @cityid varchar(500) = '1';
DECLARE @cityname varchar(500) = 'town';
DECLARE @zipcode varchar(500) = '123456';
DECLARE @address varchar(500) = 'address';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&accountemail='+@accountemail+'&modifypassword='+@modifypassword+'&accountpassword='+@accountpassword+'&namelastname='+@namelastname+'&iscompany='+@iscompany+'&companyname='+@companyname+'&documentid='+@documentid+'&language='+@language+'&countrycode='+@countrycode+'&cityid='+@cityid+'&cityname='+@cityname+'&zipcode='+@zipcode+'&address='+@address;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win| Parámetro | Descripción | Obligatorio / Opcional |
|---|---|---|
| class=subaccount | Clase a la que se realiza la petición | Obligatorio |
| method=modifysubaccount | Método de la clase al que se realiza la petición | Obligatorio |
| user | El usuario / email de su cuenta de Afilnet | Obligatorio |
| password | El password de su cuenta de Afilnet | Obligatorio |
| accountemail | Email de la cuenta | Obligatorio |
| modifypassword | Obligatorio | |
| accountpassword | Password de la cuenta | Opcional |
| namelastname | Nombre y apellidos de la persona de contacto | Obligatorio |
| iscompany | (0) Si es una persona física o (1) si es una empresa | Obligatorio |
| companyname | Nombre de la empresa (en caso de que sea empresa) | Opcional |
| documentid | Código del documento de identificación de la empresa | Obligatorio |
| language | Idioma de la subcuenta. Ver tabla adjunta | Obligatorio |
| countrycode | Código ISO del país en formato ISO-3166-1 ALPHA-2 | Obligatorio |
| cityid | Identificador de la ciudad | Obligatorio |
| cityname | Nombre de la ciudad o pueblo al que pertenece | Obligatorio |
| zipcode | Código postal | Obligatorio |
| address | Dirección fisica | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
| Código | Descripción |
|---|---|
| MISSING_USER | Usuario / email no incluido |
| MISSING_PASSWORD | Password no incluido |
| MISSING_CLASS | Clase no incluida |
| MISSING_METHOD | Método no incluido |
| MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
| INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
| INCORRECT_CLASS | Clase incorrecta |
| INCORRECT_METHOD | Método incorrecto |
| EMPTY_COUNTRYCODE | El código del país está vacío |
| EMPTY_FIELDS | Algún campo obligatorio está vacío |
| COUNTRY_NOT_FOUND | No existe ningún país con el código indicado |
| EMPTY_CITY | No ha indicado la ciudad |
| CITY_NOT_FOUND | La ciudad indicada no existe |
| INCORRECT_EMAIL | El email incluido no es válido |
| INCORRECT_PASSWORD | El password incluido no es válido |
| ACCOUNT_NOT_FOUND | La cuenta del usuario no ha sido encontrada |
Obtener listado de subcuentas con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'subaccount';
DECLARE @method varchar(500) = 'getsubaccounts';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win| Parámetro | Descripción | Obligatorio / Opcional |
|---|---|---|
| class=subaccount | Clase a la que se realiza la petición | Obligatorio |
| method=getsubaccounts | Método de la clase al que se realiza la petición | Obligatorio |
| user | El usuario / email de su cuenta de Afilnet | Obligatorio |
| password | El password de su cuenta de Afilnet | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
| Código | Descripción |
|---|---|
| MISSING_USER | Usuario / email no incluido |
| MISSING_PASSWORD | Password no incluido |
| MISSING_CLASS | Clase no incluida |
| MISSING_METHOD | Método no incluido |
| MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
| INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
| INCORRECT_CLASS | Clase incorrecta |
| INCORRECT_METHOD | Método incorrecto |
Eliminar una subcuenta con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'subaccount';
DECLARE @method varchar(500) = 'deletesubaccount';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @accountemail varchar(500) = 'email@email.com';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&accountemail='+@accountemail;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win| Parámetro | Descripción | Obligatorio / Opcional |
|---|---|---|
| class=subaccount | Clase a la que se realiza la petición | Obligatorio |
| method=deletesubaccount | Método de la clase al que se realiza la petición | Obligatorio |
| user | El usuario / email de su cuenta de Afilnet | Obligatorio |
| password | El password de su cuenta de Afilnet | Obligatorio |
| accountemail | Email de la cuenta | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
| Código | Descripción |
|---|---|
| MISSING_USER | Usuario / email no incluido |
| MISSING_PASSWORD | Password no incluido |
| MISSING_CLASS | Clase no incluida |
| MISSING_METHOD | Método no incluido |
| MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
| INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
| INCORRECT_CLASS | Clase incorrecta |
| INCORRECT_METHOD | Método incorrecto |
| ACCOUNT_NOT_FOUND | La cuenta del usuario no ha sido encontrada |
Transferir saldo a una subcuenta con SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'subaccount';
DECLARE @method varchar(500) = 'transferbalance';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @accountemail varchar(500) = 'email@email.com';
DECLARE @balancetotransfer varchar(500) = '10';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&accountemail='+@accountemail+'&balancetotransfer='+@balancetotransfer;
DECLARE @win int
DECLARE @hr int
DECLARE @text varchar(8000)
EXEC @hr=sp_OACreate 'WinHttp.WinHttpRequest.5.1',@win OUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win, 'Open',NULL,'GET',@url,'false'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAMethod @win,'Send'
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OAGetProperty @win,'ResponseText',@text OUTPUT
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win
EXEC @hr=sp_OADestroy @win
IF @hr <> 0 EXEC sp_OAGetErrorInfo @win| Parámetro | Descripción | Obligatorio / Opcional |
|---|---|---|
| class=subaccount | Clase a la que se realiza la petición | Obligatorio |
| method=transferbalance | Método de la clase al que se realiza la petición | Obligatorio |
| user | El usuario / email de su cuenta de Afilnet | Obligatorio |
| password | El password de su cuenta de Afilnet | Obligatorio |
| accountemail | Email de la cuenta | Obligatorio |
| balancetotransfer | Indica el balance a transferir a la subcuenta, se puede utilizar valor en negativo para restar balance de la subcuenta. | Obligatorio |
Respuesta:
- status
-
result (si status=success), recibirá los siguientes valores:
- No recibirá valores adicionales
- error (si status=error), aquí recibirá el código de error
Códigos de error:
| Código | Descripción |
|---|---|
| MISSING_USER | Usuario / email no incluido |
| MISSING_PASSWORD | Password no incluido |
| MISSING_CLASS | Clase no incluida |
| MISSING_METHOD | Método no incluido |
| MISSING_COMPULSORY_PARAM | Parámetro obligatorio no incluido |
| INCORRECT_USER_PASSWORD | Usuario o clave incorrectos |
| INCORRECT_CLASS | Clase incorrecta |
| INCORRECT_METHOD | Método incorrecto |
| ACCOUNT_NOT_FOUND | La cuenta del usuario no ha sido encontrada |
| NOT_ENOUGH_BALANCE | ERROR_NOT_ENOUGH_BALANCE |
| INCORRECT_MIN_BALANCE | ERROR_INCORRECT_MIN_BALANCE |
Afilnet le ofrece métodos para mejorar la seguridad al usar nuestra API con SQL Server, gracias a la posibilidad de crear accesos y la posibilidad de activar el filtrado por IP.
¿Qué API para SQL Server debo utilizar?
Descubra las ventajas e inconvenientes de cada una de nuestras APIs. Descubra cual API es mejor para su Software en SQL Server.
Esta API permite conectar con nosotros desde SQL Server para enviar peticiones a través de peticiones HTTP GET. Esta petición envía los parámetros en la misma URL de la petición.
- HTTP GET es extremadamente sencillo de implementar
- Información se envía no cifrada (Se podría extraer contraseñas de logs o caché)
- Petición máximas de ~4000 caracteres
La API de peticiones POST le permite conectar con nuestra API desde SQL Server enviando los parámetros de la petición por parámetros HTTP POST. La información se envía de forma independiente a la URL.
- HTTP POST es sencillo de implementar
- Información se envía cifrada
- No hay limite en el tamaño de la petición
- Seguridad media
La API de autenticación básica permite la utilización de peticiones GET y POST en SQL Server con una capa de seguridad adicional, ya que en este caso el usuario y clave se envía en la cabecera de la petición.
- La autenticación básica es sencilla de implementar
- Datos de acceso se envían cifrados
- El límite del tamaño depende del uso de GET o POST
- Seguridad media
SOAP le permite enviar peticiones en formato XML con SQL Server, SOAP añade capa de seguridad extra en las peticiones API.
- La integración SOAP es más compleja
- Información se envía cifrada
- No hay limite en el tamaño de la petición
- Seguridad media / alta
Nuestra API JSON le permite enviar peticiones en formato JSON con SQL Server, además esta API añade el protocolo oAuth 2.0 en la autenticación que le permite añadir una capa adicional de seguridad.
- La integración JSON oAuth 2.0 es más compleja
- Información se envía cifrada
- No hay limite en el tamaño de la petición
- Seguridad alta
Conectar SQL Server con nuestra API de Subcuentas
01
Regístrese como cliente
Para poder tener acceso a la API debe ser cliente de Afilnet. El registro le llevará pocos minutos.
02
Solicite su prueba gratuita
Nuestra empresa le ofrecerá saldo de prueba que le permitirá realizar las pruebas con la API que necesite.
03
Integre la API
Realice la integración de la API utilizando el lenguaje de programación que deseen. Si tiene alguna duda o sugerencía sobre la API contáctenos
04
¡Bienvenido a Afilnet!
¡Todo listo!, ha conseguido mejorar sus comunicaciones con Afilnet. Estamos para darle soporte de nuestra API cuando lo necesite
Contacte con nuestro equipo a través de cualquiera duda a través de los métodos de contacto que le ofrecemos. Nuestro equipo intentará ofrecerla una solución inmediata y le ayudará en la integración de nuestra API en su Software.