Comece com a API (administradores)
Natalya Yefimenko avatar
Escrito por Natalya Yefimenko
Atualizado há mais de uma semana

No Affise, você pode gerenciar a plataforma por meio da API. Para começar a trabalhar com a API, você precisa de uma chave de API e de um URL de API.

Para trabalhar com solicitações, você pode usar ferramentas gratuitas de desenvolvimento de API, como Postman, Insomnia, Advanced REST client etc.

Tipos de dados e métodos

Na API do Affise, você pode trabalhar com os seguintes tipos de dados:

  • Inteiro: somente para valores inteiros: ID da oferta, ID do afiliado etc.

  • String: inclui valores inteiros, letras e caracteres: código do país, tipo de limite, tipo de pagamento etc.

  • Array: usado com vários valores: afiliados em maiúsculas, metas em maiúsculas, etc.

  • Float: inclui um número de ponto flutuante ou decimal: pagamento para afiliado, receita, etc.

  • Mixed: String ou Array: filtros em estatísticas.

Na API do Affise, você pode usar três métodos:

  • GET: usado para solicitar dados: estatísticas, lista de anunciantes, etc.

  • POST: usado para enviar dados para criar ou atualizar um recurso: gerar e atualizar faturas, adicionar ofertas, adicionar usuários etc.

  • DELETE: usado para excluir o recurso especificado: excluir postback, excluir pixel etc.

Estrutura de solicitação da API:

GET/POST/DELETE + URL da API + caminho + ? + API key=189471975956279174174.

Exemplo de solicitação de API:

POST https://api-rocketcompany.affise.com/3.0/admin/offer?API-key=1ca97dd8c1b19bf8ae554c063112a489

Use o cabeçalho content-type - application/x-www-form-urlencoded e o tipo de conteúdo multipart/form-data para gerenciar logotipos.

Articles _ Affise _ Interco.. 2022-12-02 at 11.10.48 AM. - Google Chrome

Chave da API

Para autenticação de troca de dados, você deve passar uma chave de API como um parâmetro no cabeçalho.

Chave de API do painel do administrador

A chave da API do painel do administrador está localizada aqui: Usuários > Gerenciamento de usuários > um determinado usuário.

Users Management _ Rocketcompany - Google Chrome 2022-08-11 at 5.38.17 PM

Chaves de API e usuários

Somente um gerente geral tem permissão para obter uma chave de API na página de edição do usuário.

Um gerente geral tem acesso a todas as seções e tem permissão para obter uma chave de API de qualquer usuário e afiliado.

As chaves de API de gerentes de afiliados e gerentes de contas funcionam somente para as solicitações de API das seções às quais eles têm acesso.

Chave de API do painel de afiliados

Se você quiser configurar a integração da API com o Afiliado, ele também precisará de uma chave de API para ter acesso à API.

A chave de API do Afiliado está localizada no painel do Afiliado: Configurações > Segurança.

Profile _ Security - Google Chrome 2022-08-12 at 10.43.03 AM

URL DA API

O URL da API é o núcleo de sua solicitação de API.

O URL da API está localizado aqui: Configurações > Configurações > Domínios de rastreamento > URL padrão.

Domains - Google Chrome 2022-08-12 at 10.54.56 AM

⚠️ O URL da API leva ao documento da API. Encontre o documento API v.3.1. Doc aqui.


Entre em contato com a equipe de Suporte ao Cliente da Affise sobre todas as questões levantadas por meio do e-mail: [email protected].

Respondeu à sua pergunta?