API di gestione degli utenti in SQL Server
Gestisci le informazioni sugli utenti, conosci il saldo che hai nel tuo account e gestisci i tuoi indirizzi.
Prendere la bilancia dei pagamenti 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) = 'user';
DECLARE @method varchar(500) = 'getbalance';
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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=getbalance | 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 |
Aggiungi nuovo indirizzo 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) = 'user';
DECLARE @method varchar(500) = 'addaddress';
DECLARE @user varchar(500) = 'user';
DECLARE @password 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 @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+'&namelastname='+@namelastname+'&iscompany='+@iscompany+'&companyname='+@companyname+'&documentid='+@documentid+'&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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=addaddress | 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 |
| 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 |
| 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 |
| 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 |
Rimuovi un indirizzo 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) = 'user';
DECLARE @method varchar(500) = 'deleteaddress';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idaddress varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idaddress='+@idaddress;
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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=deleteaddress | 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 |
| idaddress | ID indirizzo account utente | 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 |
Ottieni l'elenco di indirizzi 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) = 'user';
DECLARE @method varchar(500) = 'getaddresses';
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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=getaddresses | 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:
-
list
- id
- namelastname
- iscompany
- companyname
- documentid
- countrycode
- cityid
- cityname
- zipcode
- address
- verified
- addressverified
-
list
- 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 |
Ottieni l'elenco dei canali 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) = 'user';
DECLARE @method varchar(500) = 'getchannels';
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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=getchannels | 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:
-
list
- channeltype
- channelname
- active
-
list
- 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 |
Modifica lo stato di un canale 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) = 'user';
DECLARE @method varchar(500) = 'modifychannel';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @channelname varchar(500) = 'sms';
DECLARE @active varchar(500) = '1';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&channelname='+@channelname+'&active='+@active;
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=user | Classe alla quale si realizza la richiesta | Obbligatorio |
| method=modifychannel | 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 |
| channelname | Nome del canale | Obbligatorio |
| active | (1) Abilita o (0) Disabilita | 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 |
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 Utente
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.