README

Introdução

Bem-vindo à documentação oficial da API da Plataforma de Promoção IdPlugger exclusiva para administradores da API!

Se você está procurando a documentação destinada ao cliente da Plataforma de Promoção IdPlugger acesse clicando aqui!

Sobre a API

Esta API é baseada em REST, proporcionando uma arquitetura flexível e de fácil integração.

Começando

Para começar a explorar e utilizar a API da Plataforma de Promoção IdPlugger, recomendamos que você siga os seguintes passos:

Postman: Baixe a collection do postman, instale o postman na sua máquina e importe a collection.
Autenticação: Obtenha suas credenciais de autenticação ('username' e 'password') de administrador, para acessar a API.
Explorar Endpoints: Navegue pela lista de endpoints disponíveis e suas respectivas funcionalidades.
Experimentar: Utilize os exemplos de solicitação fornecidos para testar os endpoints e compreender melhor seu funcionamento.
Integrar: Integre a API da Plataforma de Promoção IdPlugger em seus próprios projetos e sistemas para aproveitar ao máximo suas capacidades.

Autenticação

Todos os endpoints requerem token de autenticação válido, que pode ser obtido através de requisição à API enviando as credenciais obtidas.

Este token é do tipo bearer e deve ser enviado no header da requisição no seguinte formato:

Header	Valor
Authorization	bearer `{token}`

Substitua {token} pelo token obtido na autenticação.

IMPORTANTE: O bearer token tem um tempo de validade, o ideal é armazenar o bearer token e solicitar um novo token apenas quando o seu token expirar. A validade do token é enviada junto com o token na resposta do endpoint de autenticação.

Configurações de Promoção

Pull Configurations

O primeiro passo para configurar uma promoção na API é puxar a parametrização da promoção criada. Para isto, libere o servidor da API para acesso ao banco de dados da promoção e informe os dados de conexão através da rota Pull Configuration

Steps

Após puxar as configurações na etapa anterior, configure as steps da promoção. Steps são as partes de código que serão executadas para cada promoção. Cada promoção pode ter uma configuração diferente de steps.

Para consultar quais steps estão disponíveis, utilize este endpoint
Para ativar steps em uma promoção, utilize este endpoint
Para desativar steps em uma promoção, utilize este endpoint
Para consultar quais steps estão ativas, utilize o endpoint de ativação sem passar nenhuma step

Algumas steps são configuradas por padrão ao fazer o pull configuration, para saber quais confira o parâmetro default na resposta do endpoint de consulta de steps. Este endpoint também retorna a descrição do que a step faz e se ela depende que outra esteja ativada ou desativada.

Criar Usuário da API

Para que um cliente possa utilizar a API, é necessário criar um usuário para ele.

Para isto, após fazer o pull configuration e a parametrização de steps, utilize este endpoint para criar um usuário da API. Este endpoint cria o usuário e retorna uma senha para este usuário.

Permissões do usuário da API

Após criar o usuário, é necessário dar as permissões para que ele possa atuar na promoção. Para isso, utilize este endpoint.

Atenção: Selecione bem as permissões, deixando apenas as necessárias.

Teste

Utilize as credenciais do usuário criado para testar se a API está respondendo para a promoção configurada.

Postman Collection

Installation & Usage

Requirements

PHP 8.1 and later.

Composer

To install the bindings via Composer, add the following to composer.json:

{
  "repositories": [
    {
      "type": "vcs",
      "url": "https://github.com/GIT_USER_ID/GIT_REPO_ID.git"
    }
  ],
  "require": {
    "GIT_USER_ID/GIT_REPO_ID": "*@dev"
  }
}

Then run composer install

Manual Installation

Download the files and include autoload.php:

<?php
require_once('/path/to/handsondigital/lib.php.admin.idplugger/vendor/autoload.php');

Getting Started

Please follow the installation procedure and then run the following:

<?php
require_once(__DIR__ . '/vendor/autoload.php');




$apiInstance = new IdpluggerPromotionAdmin\Api\AuthApi(
    // If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
    // This is optional, `GuzzleHttp\Client` will be used as default.
    new GuzzleHttp\Client()
);
$admin_auth_request_token_request = new \IdpluggerPromotionAdmin\Model\AdminAuthRequestTokenRequest(); // \IdpluggerPromotionAdmin\Model\AdminAuthRequestTokenRequest

try {
    $result = $apiInstance->adminAuthRequestToken($admin_auth_request_token_request);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AuthApi->adminAuthRequestToken: ', $e->getMessage(), PHP_EOL;
}

API Endpoints

All URIs are relative to https://api.idplugger.com

Class	Method	HTTP request	Description
AuthApi	adminAuthRequestToken	POST /admin/auth/request-token	Solicita envio de token de login por email
AuthApi	authLogin	POST /v3/login	Login na API
AuthApi	authLoginByToken	POST /admin/auth/login	Login na API via e-mail e token
AuthApi	authMe	GET /v3/me	Dados na API
AuthApi	authRefreshToken	POST /admin/auth/refresh	Renova o do token de autenticação
MetricsApi	metrics	GET /v3/metrics	Devolve as métricas da promoção
PromotionApi	promotionPullConfiguration	POST /v3/admin/pullconfiguration	Adicionar/Atualizar configurações de uma promoção ao orquestrador
PromotionApi	promotionStart	POST /v3/admin/promotion/start	Iniciar uma promoção na API
RolesApi	rolesAttachPermissions	POST /v3/admin/roles/{id}/permissions	Atualizar permissões de uma role
RolesApi	rolesDestroy	DELETE /v3/admin/roles/{id}	Remover role
RolesApi	rolesIndex	GET /v3/admin/roles	Listar roles
RolesApi	rolesPermissions	GET /v3/admin/roles/{id}/permissions	Listar permissões de uma role
RolesApi	rolesShow	GET /v3/admin/roles/{id}	Exibir detalhes da role
RolesApi	rolesStore	POST /v3/admin/roles	Criar role
RolesApi	rolesUpdate	PATCH /v3/admin/roles/{id}	Atualizar role
StepsApi	stepsAllow	POST /v3/steps/allow	Inclui uma Step em um determinado endpoint
StepsApi	stepsIndex	GET /v3/steps	Retorna todas as steps existentes
StepsApi	stepsUnallow	POST /v3/steps/disallow	Remove uma Step de um determinado endpoint
UserApi	userGrantPermissions	POST /v3/admin/user/grantpermissions	Dar permissões a um usuário na API
UserApi	userRegister	POST /v3/admin/user/register	Registrar usuário na API
UserApi	userShow	GET /v3/admin/user/{uuid}	Visualizar dados do usuário na API
UserApi	userUpdate	PATCH /v3/admin/user/{uuid}	Atualizar nome do usuário na API

Models

Authorization

Authentication schemes defined for the API:

bearerAuth

Type: Bearer authentication (JWT)

Tests

To run the tests, use:

composer install
vendor/bin/phpunit

Author

About this package

This PHP package is automatically generated by the OpenAPI Generator project:

API version: 3.0.0
- Generator version: 7.13.0
Build package: org.openapitools.codegen.languages.PhpClientCodegen

handsondigital/lib.php.admin.idplugger

包简介

关键字：

README 文档