API rivenditore per SQL Server
Gestisci il tuo account rivenditore con la nostra API per SQL Server in modo semplice e sicuro. Prova gratuitamente la nostra API per SQL Server. Il nostro team ti aiuterà a gestire i clienti del tuo account rivenditore in SQL Server.
Funzionalità API per i rivenditori
Aggiungi un subaccount 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| Impostazione | Descrizione | Obbligatorio / Opzionale |
|---|---|---|
| class=subaccount | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=addsubaccount | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
| user | L’utente / email del suo conto Afilnet | Obbligatorio |
| password | La password del suo conto Afilnet | Obbligatorio |
| accountemail | Account e-mail | Obbligatorio |
| accountpassword | Password dell'account | Obbligatorio |
| namelastname | Nome e cognome della persona di contatto | Obbligatorio |
| iscompany | (0) Se è una persona fisica o (1) se è una società | Obbligatorio |
| companyname | Nome dell'azienda (nel caso si tratti di un'azienda) | Opzionale |
| documentid | Codice documento identificativo della società | Obbligatorio |
| language | Lingua del subaccount. Vedi tabella allegata | Obbligatorio |
| countrycode | Codice paese ISO nel formato ISO-3166-1 ALPHA-2 | Obbligatorio |
| cityid | Identificatore della città | Obbligatorio |
| cityname | Nome della città o paese a cui appartiene | Obbligatorio |
| zipcode | codice postale | Obbligatorio |
| address | Indirizzo fisico | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
| Codice | Descrizione |
|---|---|
| MISSING_USER | Utente / email non aggiunta |
| MISSING_PASSWORD | Password non aggiunta |
| MISSING_CLASS | Categoria non inclusa |
| MISSING_METHOD | Metodo non incluso |
| MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
| INCORRECT_USER_PASSWORD | Utente o password incorretti |
| INCORRECT_CLASS | Categoria incorretta |
| INCORRECT_METHOD | Metodo incorretto |
| EMPTY_COUNTRYCODE | Il prefisso internazionale è vuoto |
| EMPTY_FIELDS | Alcuni campi obbligatori sono vuoti |
| COUNTRY_NOT_FOUND | Non esiste un paese con il codice indicato |
| EMPTY_CITY | Non hai indicato la città |
| CITY_NOT_FOUND | La città indicata non esiste |
| INCORRECT_EMAIL | L'email inclusa non è valida |
| INCORRECT_PASSWORD | La password inclusa non è valida |
| RESELLER_ACCOUNT_REQUIRED | L'account dell'utente non ha il piano rivenditore attivo |
Modifica un subaccount 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| Impostazione | Descrizione | Obbligatorio / Opzionale |
|---|---|---|
| class=subaccount | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=modifysubaccount | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
| user | L’utente / email del suo conto Afilnet | Obbligatorio |
| password | La password del suo conto Afilnet | Obbligatorio |
| accountemail | Account e-mail | Obbligatorio |
| modifypassword | Obbligatorio | |
| accountpassword | Password dell'account | Opzionale |
| namelastname | Nome e cognome della persona di contatto | Obbligatorio |
| iscompany | (0) Se è una persona fisica o (1) se è una società | Obbligatorio |
| companyname | Nome dell'azienda (nel caso si tratti di un'azienda) | Opzionale |
| documentid | Codice documento identificativo della società | Obbligatorio |
| language | Lingua del subaccount. Vedi tabella allegata | Obbligatorio |
| countrycode | Codice paese ISO nel formato ISO-3166-1 ALPHA-2 | Obbligatorio |
| cityid | Identificatore della città | Obbligatorio |
| cityname | Nome della città o paese a cui appartiene | Obbligatorio |
| zipcode | codice postale | Obbligatorio |
| address | Indirizzo fisico | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
| Codice | Descrizione |
|---|---|
| MISSING_USER | Utente / email non aggiunta |
| MISSING_PASSWORD | Password non aggiunta |
| MISSING_CLASS | Categoria non inclusa |
| MISSING_METHOD | Metodo non incluso |
| MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
| INCORRECT_USER_PASSWORD | Utente o password incorretti |
| INCORRECT_CLASS | Categoria incorretta |
| INCORRECT_METHOD | Metodo incorretto |
| EMPTY_COUNTRYCODE | Il prefisso internazionale è vuoto |
| EMPTY_FIELDS | Alcuni campi obbligatori sono vuoti |
| COUNTRY_NOT_FOUND | Non esiste un paese con il codice indicato |
| EMPTY_CITY | Non hai indicato la città |
| CITY_NOT_FOUND | La città indicata non esiste |
| INCORRECT_EMAIL | L'email inclusa non è valida |
| INCORRECT_PASSWORD | La password inclusa non è valida |
| ACCOUNT_NOT_FOUND | L'account utente non è stato trovato |
Ottieni un elenco di subaccount 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| Impostazione | Descrizione | Obbligatorio / Opzionale |
|---|---|---|
| class=subaccount | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=getsubaccounts | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
| user | L’utente / email del suo conto Afilnet | Obbligatorio |
| password | La password del suo conto Afilnet | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
| Codice | Descrizione |
|---|---|
| MISSING_USER | Utente / email non aggiunta |
| MISSING_PASSWORD | Password non aggiunta |
| MISSING_CLASS | Categoria non inclusa |
| MISSING_METHOD | Metodo non incluso |
| MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
| INCORRECT_USER_PASSWORD | Utente o password incorretti |
| INCORRECT_CLASS | Categoria incorretta |
| INCORRECT_METHOD | Metodo incorretto |
Elimina un subaccount 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| Impostazione | Descrizione | Obbligatorio / Opzionale |
|---|---|---|
| class=subaccount | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=deletesubaccount | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
| user | L’utente / email del suo conto Afilnet | Obbligatorio |
| password | La password del suo conto Afilnet | Obbligatorio |
| accountemail | Account e-mail | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
| Codice | Descrizione |
|---|---|
| MISSING_USER | Utente / email non aggiunta |
| MISSING_PASSWORD | Password non aggiunta |
| MISSING_CLASS | Categoria non inclusa |
| MISSING_METHOD | Metodo non incluso |
| MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
| INCORRECT_USER_PASSWORD | Utente o password incorretti |
| INCORRECT_CLASS | Categoria incorretta |
| INCORRECT_METHOD | Metodo incorretto |
| ACCOUNT_NOT_FOUND | L'account utente non è stato trovato |
Trasferisci il saldo a un subaccount 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| Impostazione | Descrizione | Obbligatorio / Opzionale |
|---|---|---|
| class=subaccount | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=transferbalance | Metodo della classe alla quale si realizza la richiesta | Obbligatorio |
| user | L’utente / email del suo conto Afilnet | Obbligatorio |
| password | La password del suo conto Afilnet | Obbligatorio |
| accountemail | Account e-mail | Obbligatorio |
| balancetotransfer | Indica il saldo da trasferire al subaccount, un valore negativo può essere utilizzato per sottrarre il saldo dal subaccount. | Obbligatorio |
Risposta:
- stato
-
result (si status=success), ricevera i seguenti valori:
- Non ricevera valori addizionali
- error (si status=error), qui ricevera il codice errore
Codici di errore:
| Codice | Descrizione |
|---|---|
| MISSING_USER | Utente / email non aggiunta |
| MISSING_PASSWORD | Password non aggiunta |
| MISSING_CLASS | Categoria non inclusa |
| MISSING_METHOD | Metodo non incluso |
| MISSING_COMPULSORY_PARAM | Impostazione obbligatoria non inclusa |
| INCORRECT_USER_PASSWORD | Utente o password incorretti |
| INCORRECT_CLASS | Categoria incorretta |
| INCORRECT_METHOD | Metodo incorretto |
| ACCOUNT_NOT_FOUND | L'account utente non è stato trovato |
| NOT_ENOUGH_BALANCE | ERROR_NOT_ENOUGH_BALANCE |
| INCORRECT_MIN_BALANCE | ERROR_INCORRECT_MIN_BALANCE |
Afilnet ti offre metodi per migliorare la sicurezza quando utilizzi la nostra API con SQL Server, grazie alla possibilità di creare accessi e alla possibilità di attivare il filtraggio per IP.
Quale API per SQL Server dovrei usare?
Scopri i vantaggi e gli svantaggi di ciascuna delle nostre API. Scopri quale API è la migliore per il tuo software in SQL Server.
Questa API ti consente di connetterti a noi da SQL Server per inviare richieste tramite richieste HTTP GET. Questa richiesta invia i parametri nello stesso URL della richiesta.
- HTTP GET è estremamente semplice da implementare
- Le informazioni vengono inviate non crittografate (le password possono essere estratte dai registri o dalla cache)
- Richiesta massima di ~4000 caratteri
L'API di richiesta POST ti consente di connetterti alla nostra API da SQL Server inviando parametri di richiesta tramite parametri POST HTTP. Le informazioni vengono inviate indipendentemente dall'URL.
- HTTP POST è semplice da implementare
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Sicurezza media
L'API di autenticazione di base consente l'utilizzo di richieste GET e POST in SQL Server con un livello di sicurezza aggiuntivo, poiché in questo caso nome utente e password vengono inviati nell'intestazione della richiesta.
- L'autenticazione di base è facile da implementare
- I dati di accesso vengono inviati crittografati
- Il limite di dimensione dipende dall'uso di GET o POST
- Sicurezza media
SOAP ti consente di inviare richieste in formato XML con SQL Server, SOAP aggiunge un ulteriore livello di sicurezza alle richieste API.
- L'integrazione di SOAP è più complessa
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Sicurezza medio/alta
La nostra API JSON ti consente di inviare richieste in formato JSON con SQL Server, inoltre questa API aggiunge il protocollo oAuth 2.0 nell'autenticazione che ti consente di aggiungere un ulteriore livello di sicurezza.
- L'integrazione di JSON oAuth 2.0 è più complessa
- Le informazioni vengono inviate crittografate
- Non c'è limite alla dimensione della richiesta
- Alta sicurezza
Connetti SQL Server con la nostra API Account secondari
01
Registrati come cliente
Per poter accedere all'API devi essere un client Afilnet. La registrazione richiederà alcuni minuti.
02
Richiedi la tua prova gratuita
La nostra azienda ti offrirà un saldo di prova che ti consentirà di testare con l'API di cui hai bisogno.
03
Integra l'API
Esegui l'integrazione API utilizzando il linguaggio di programmazione di tua scelta. Se hai domande o suggerimenti sull'API, contattaci
04
Benvenuti in Afilnet!
Tutto pronto!, È riuscito a migliorare le sue comunicazioni con Afilnet. Siamo qui per supportare la nostra API quando ne hai bisogno
Contatta il nostro team per qualsiasi domanda tramite i metodi di contatto che offriamo. Il nostro team cercherà di offrirti una soluzione immediata e ti aiuterà nell'integrazione della nostra API nel tuo Software.