API de contatos
Gerencie seus grupos (crie, modifique ou exclua grupos) e contatos com nossa API para contatos.
Criar grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'creategroup';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @name varchar(500) = 'test name';
DECLARE @type varchar(500) = 'mobile';
DECLARE @fields varchar(500) = 'mobile,name,address';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&name='+@name+'&type='+@type+'&fields='+@fields;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=creategroup | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| name | Nome do grupo | Mandatório |
| type | Tipo de grupo (email ou móvel) | Mandatório |
| fields | Lista de campos separados por vírgulas. É obrigatório incluir um campo de telemóvel se tipo = mobile e um campo de email se tipo = email | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| INCORRECT_TYPE | Tipo incorreto. O tipo deve ser mobile ou email |
| MISSING_MAIN_FIELD | Campo principal em falta (mobile se tipo = mobile ou email se tipo = email) |
Obter campo de um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'getgroupcolumns';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=getgroupcolumns | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Adicionar a um grupo um campo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'addcolumntogroup';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @field varchar(500) = 'name';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&field='+@field;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=addcolumntogroup | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| field | Campo do grupo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Eliminar campo de um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'deletecolumnfromgroup';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @field varchar(500) = 'name';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&field='+@field;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=deletecolumnfromgroup | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| field | Campo do grupo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Excluir um contato de grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'deletegroup';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=deletegroup | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Atribuir um país a um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'assigncountrytogroup';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @countryiso3 varchar(500) = 'esp';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&countryiso3='+@countryiso3;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=assigncountrytogroup | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| countryiso3 | Código ISO do país | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
| COUNTRY_NOT_FOUND | Não há nenhum país com o código indicado |
Obter contactos de grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'getcontacts';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=getcontacts | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Obter um contato de um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'getcontact';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @idcontact varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&idcontact='+@idcontact;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=getcontact | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | ID do grupo | Mandatório |
| idcontact | ID de contato | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
| NOT_ACCESS_TO_CONTACT | ERROR_NOT_ACCESS_TO_CONTACT |
Adicionar um contacto a um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'addcontact';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @contact varchar(500) = 'mobile:123456789,name:testname';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&contact='+@contact;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=addcontact | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| contact | Contacto a ser adicionado com os seus campos separados por vírgulas, ver exemplo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| CONTACT_EXISTS | O contacto já se encontra no grupo |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Adicionar uma lista de contatos a um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'addcontactlist';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @contacts varchar(500) = '[{\"name\":\"Test\",\"mobile\":\"34600000000\"},{\"name\":\"Test\",\"mobile\":\"34600000001\"}]';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&contacts='+@contacts;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=addcontactlist | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | ID do grupo | Mandatório |
| contacts | Lista de contatos em formato JSON | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Modificar contacto de um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'modifycontact';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @idcontact varchar(500) = '1000';
DECLARE @contact varchar(500) = 'mobile:123456789,name:testname';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&idcontact='+@idcontact+'&contact='+@contact;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=modifycontact | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| idcontact | Identificador do contacto | Mandatório |
| contact | Contacto a ser adicionado com os seus campos separados por vírgulas, ver exemplo | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
Eliminar contacto de um grupo com SQL Server
sp_configure 'show advanced options', 1;
GO
RECONFIGURE;
GO
sp_configure 'Ole Automation Procedures', 1;
GO
RECONFIGURE;
GO
DECLARE @class varchar(500) = 'group';
DECLARE @method varchar(500) = 'deletecontact';
DECLARE @user varchar(500) = 'user';
DECLARE @password varchar(500) = 'password';
DECLARE @idgroup varchar(500) = '1000';
DECLARE @idcontact varchar(500) = '1000';
DECLARE @url varchar(255) = 'https://www.afilnet.com/api/http/?+'&class='+@class+'&method='+@method+'&user='+@user+'&password='+@password+'&idgroup='+@idgroup+'&idcontact='+@idcontact;
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 | Descrição | Mandatório / Opcional |
|---|---|---|
| class=group | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
| method=deletecontact | Método de classe requisitado: Método da classe à qual o pedido é requisitado | Mandatório |
| user | Utilizador e email da sua conta Afilnet | Mandatório |
| password | Password da sua conta Afilnet | Mandatório |
| idgroup | Identificador do grupo | Mandatório |
| idcontact | Identificador do contacto | Mandatório |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
- Não lhe será enviado qualquer valor adicional
- error (if status=error), aqui receberá o código de erro
Códigos de erro:
| Código | Descrição |
|---|---|
| MISSING_USER | Utilizador ou email não incluído |
| MISSING_PASSWORD | Password não incluída |
| MISSING_CLASS | Classe não incluída |
| MISSING_METHOD | Método não incluído |
| MISSING_COMPULSORY_PARAM | Parâmetro obrigatório não incluído |
| INCORRECT_USER_PASSWORD | Utilizador ou password incorretos |
| INCORRECT_CLASS | Classe incorreta |
| INCORRECT_METHOD | Método incorreto |
| NOT_ACCESS_TO_GROUP | Não tem acesso ao grupo indicado |
A Afilnet oferece-lhe métodos para melhorar a segurança ao utilizar a nossa API com SQL Server, graças à possibilidade de criar acessos e à possibilidade de ativar a filtragem por IP.
Qual API para SQL Server devo usar?
Descubra as vantagens e desvantagens de cada uma das nossas APIs. Descubra qual API é melhor para o seu Software em SQL Server.
Essa API permite que você se conecte a nós de SQL Server para enviar solicitações por meio de solicitações HTTP GET. Essa solicitação envia os parâmetros na mesma URL da solicitação.
- HTTP GET é extremamente simples de implementar
- As informações são enviadas sem criptografia (as senhas podem ser extraídas de logs ou cache)
- Solicitação máxima de aproximadamente 4.000 caracteres
A API de solicitação POST permite que você se conecte à nossa API de SQL Server enviando parâmetros de solicitação por meio de parâmetros HTTP POST. As informações são enviadas independentemente da URL.
- HTTP POST é simples de implementar
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Segurança média
A API de autenticação básica permite o uso de solicitações GET e POST em SQL Server com uma camada de segurança adicional, pois neste caso o nome de usuário e a senha são enviados no cabeçalho da solicitação.
- A autenticação básica é fácil de implementar
- Os dados de acesso são enviados criptografados
- O limite de tamanho depende do uso de GET ou POST
- Segurança média
SOAP permite enviar solicitações em formato XML com SQL Server, SOAP adiciona uma camada extra de segurança às solicitações de API.
- A integração SOAP é mais complexa
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Segurança média/alta
Nossa API JSON permite enviar solicitações em formato JSON com SQL Server, além disso, essa API adiciona o protocolo oAuth 2.0 na autenticação que permite adicionar uma camada adicional de segurança.
- A integração JSON oAuth 2.0 é mais complexa
- As informações são enviadas criptografadas
- Não há limite para o tamanho da solicitação
- Alta seguranca
Conecte SQL Server com nossa API CONTATOS
01
Registre-se como um cliente
Para ter acesso à API você deve ser um cliente Afilnet. O registro levará alguns minutos.
02
Solicite sua avaliação gratuita
Nossa empresa lhe oferecerá um balancete que lhe permitirá testar com a API que você precisa.
03
Integrar a API
Realize a integração da API usando a linguagem de programação de sua escolha. Se você tiver dúvidas ou sugestões sobre a API, entre em contato conosco
04
Bem vindo ao Afilnet!
Tudo pronto!, conseguiu melhorar as suas comunicações com a Afilnet. Estamos aqui para dar suporte à nossa API quando você precisar
Em caso de dúvidas, entre em contato com nossa equipe através dos meios de contato que oferecemos. Nossa equipe tentará lhe oferecer uma solução imediata e lhe ajudará na integração de nossa API em seu Software.