API de gerenciamento de usuários em Oracle
Gerencie as informações do usuário, saiba o saldo que você tem em sua conta e gerencie seus endereços.
Obter saldo de conta com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getbalance | 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 |
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 |
Adicione um novo endereço com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=addaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'namelastname=name+lastname'||'&'||'iscompany=1'||'&'||'companyname=mycompany'||'&'||'documentid=123456789A'||'&'||'countrycode=us'||'&'||'cityid=1'||'&'||'cityname=town'||'&'||'zipcode=123456'||'&'||'address=address';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=addaddress | 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 |
namelastname | Nome e sobrenome da pessoa de contato | Mandatório |
iscompany | (0) Se for pessoa física ou (1) se for uma empresa | Mandatório |
companyname | Nome da empresa (no caso de ser uma empresa) | Opcional |
documentid | Código do documento de identificação da empresa | Mandatório |
countrycode | Código ISO do país no formato ISO-3166-1 ALPHA-2 | Mandatório |
cityid | Identificador de cidade | Mandatório |
cityname | Nome da cidade ou vila a que pertence | Mandatório |
zipcode | Código postal | Mandatório |
address | Endereço físico | 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 |
EMPTY_COUNTRYCODE | O código do país está vazio |
COUNTRY_NOT_FOUND | Não há nenhum país com o código indicado |
EMPTY_CITY | Você não indicou a cidade |
CITY_NOT_FOUND | A cidade indicada não existe |
Remova um endereço com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=addaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'namelastname=name+lastname'||'&'||'iscompany=1'||'&'||'companyname=mycompany'||'&'||'documentid=123456789A'||'&'||'countrycode=us'||'&'||'cityid=1'||'&'||'cityname=town'||'&'||'zipcode=123456'||'&'||'address=address';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=deleteaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'idaddress=1000';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=deleteaddress | 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 |
idaddress | ID do endereço da conta do usuário | 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 |
Obtenha a lista de endereços com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=addaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'namelastname=name+lastname'||'&'||'iscompany=1'||'&'||'companyname=mycompany'||'&'||'documentid=123456789A'||'&'||'countrycode=us'||'&'||'cityid=1'||'&'||'cityname=town'||'&'||'zipcode=123456'||'&'||'address=address';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=deleteaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'idaddress=1000';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=getaddresses'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getaddresses | 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 |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- id
- namelastname
- iscompany
- companyname
- documentid
- countrycode
- cityid
- cityname
- zipcode
- address
- verified
- addressverified
-
list
- 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 |
Obtenha uma lista de canais com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=addaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'namelastname=name+lastname'||'&'||'iscompany=1'||'&'||'companyname=mycompany'||'&'||'documentid=123456789A'||'&'||'countrycode=us'||'&'||'cityid=1'||'&'||'cityname=town'||'&'||'zipcode=123456'||'&'||'address=address';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=deleteaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'idaddress=1000';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=getaddresses'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=getchannels'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=getchannels | 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 |
Responda:
- status
-
result (if status=success), aqui receberá os seguintes valores:
-
list
- channeltype
- channelname
- active
-
list
- 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 |
Modifique o status de um canal com Oracle
declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?class=user'||'&'||'method=getbalance'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=addaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'namelastname=name+lastname'||'&'||'iscompany=1'||'&'||'companyname=mycompany'||'&'||'documentid=123456789A'||'&'||'countrycode=us'||'&'||'cityid=1'||'&'||'cityname=town'||'&'||'zipcode=123456'||'&'||'address=address';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=deleteaddress'||'&'||'user=user'||'&'||'password=password'||'&'||'idaddress=1000';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=getaddresses'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=getchannels'||'&'||'user=user'||'&'||'password=password';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;declare
l_url varchar2(200) := 'http://www.afilnet.com/api/http/?'||'&'||'class=user'||'&'||'method=modifychannel'||'&'||'user=user'||'&'||'password=password'||'&'||'channelname=sms'||'&'||'active=1';
l_req utl_http.req;
l_resp utl_http.resp;
l_text varchar2(32767);
begin
l_req := utl_http.begin_request(l_url);
l_resp := utl_http.get_response(l_req);
begin
loop
utl_http.read_text(l_resp, l_text, 32766);
dbms_output.put_line(l_text);
end loop;
exception
when utl_http.end_of_body then
utl_http.end_response(l_resp);
end;
end;
Parâmetro | Descrição | Mandatório / Opcional |
---|---|---|
class=user | Classe pedida: Classe à qual o pedido é requisitado | Mandatório |
method=modifychannel | 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 |
channelname | Nome do canal | Mandatório |
active | (1) Habilitar ou (0) Desabilitar | 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 |
Qual API para Oracle devo usar?
Descubra as vantagens e desvantagens de cada uma das nossas APIs. Descubra qual API é melhor para o seu Software em Oracle.
Essa API permite que você se conecte a nós de Oracle 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 Oracle 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 Oracle 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 Oracle, 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 Oracle, 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 Oracle com nossa API Utilizador
Registre-se como um cliente
Para ter acesso à API você deve ser um cliente Afilnet. O registro levará alguns minutos.
Solicite sua avaliação gratuita
Nossa empresa lhe oferecerá um balancete que lhe permitirá testar com a API que você precisa.
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
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.