@handsondigital/idplugger-promotion 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.openapi-generator/FILES +267 -0
- package/.openapi-generator/VERSION +1 -0
- package/.openapi-generator-ignore +23 -0
- package/README.md +367 -0
- package/api.ts +14329 -0
- package/base.ts +98 -0
- package/common.ts +150 -0
- package/configuration.ts +115 -0
- package/dist/api.d.ts +10994 -0
- package/dist/api.js +7834 -0
- package/dist/base.d.ts +66 -0
- package/dist/base.js +99 -0
- package/dist/common.d.ts +65 -0
- package/dist/common.js +253 -0
- package/dist/configuration.d.ts +91 -0
- package/dist/configuration.js +57 -0
- package/dist/index.d.ts +13 -0
- package/dist/index.js +31 -0
- package/docs/AddLuckyNumberCustom.md +26 -0
- package/docs/Article.md +40 -0
- package/docs/ArticleCustomDataInner.md +28 -0
- package/docs/ArticlesApi.md +258 -0
- package/docs/ArticlesCreate200Response.md +26 -0
- package/docs/ArticlesCreate400Response.md +26 -0
- package/docs/ArticlesCreate401Response.md +26 -0
- package/docs/ArticlesDelete200Response.md +26 -0
- package/docs/ArticlesDelete400Response.md +26 -0
- package/docs/ArticlesDelete401Response.md +26 -0
- package/docs/ArticlesIndex200Response.md +28 -0
- package/docs/ArticlesIndex400Response.md +26 -0
- package/docs/ArticlesIndex401Response.md +26 -0
- package/docs/ArticlesUpdate200Response.md +26 -0
- package/docs/ArticlesUpdate400Response.md +26 -0
- package/docs/ArticlesUpdate401Response.md +26 -0
- package/docs/AuthApi.md +105 -0
- package/docs/Award.md +40 -0
- package/docs/Awarded.md +38 -0
- package/docs/AwardedsApi.md +184 -0
- package/docs/AwardedsSearch200Response.md +28 -0
- package/docs/AwardedsSearch400Response.md +26 -0
- package/docs/AwardedsSearch401Response.md +26 -0
- package/docs/AwardedsStates200Response.md +26 -0
- package/docs/AwardedsStates200ResponseContentInner.md +22 -0
- package/docs/AwardedsUpdate200Response.md +26 -0
- package/docs/AwardedsUpdate400Response.md +26 -0
- package/docs/AwardedsUpdate401Response.md +26 -0
- package/docs/AwardsApi.md +243 -0
- package/docs/AwardsCreate200Response.md +26 -0
- package/docs/AwardsCreate400Response.md +26 -0
- package/docs/AwardsCreate401Response.md +26 -0
- package/docs/AwardsDelete200Response.md +26 -0
- package/docs/AwardsDelete400Response.md +26 -0
- package/docs/AwardsDelete401Response.md +26 -0
- package/docs/AwardsIndex200Response.md +28 -0
- package/docs/AwardsIndex400Response.md +26 -0
- package/docs/AwardsIndex401Response.md +26 -0
- package/docs/AwardsUpdate200Response.md +26 -0
- package/docs/AwardsUpdate400Response.md +26 -0
- package/docs/AwardsUpdate401Response.md +26 -0
- package/docs/BlacklistCreate200Response.md +26 -0
- package/docs/BlacklistCreate200ResponseContentInner.md +24 -0
- package/docs/BlacklistCreate400Response.md +26 -0
- package/docs/BlacklistCreate401Response.md +26 -0
- package/docs/BlacklistCreateRequest.md +20 -0
- package/docs/BlacklistDelete200Response.md +26 -0
- package/docs/BlacklistDelete400Response.md +26 -0
- package/docs/BlacklistDelete401Response.md +26 -0
- package/docs/BlacklistIndex200Response.md +28 -0
- package/docs/BlacklistIndex200ResponseContentInner.md +24 -0
- package/docs/BlacklistIndex400Response.md +26 -0
- package/docs/BlockedUsersApi.md +179 -0
- package/docs/Branding.md +54 -0
- package/docs/BrandingApi.md +120 -0
- package/docs/BrandingIndex200Response.md +26 -0
- package/docs/BrandingIndex400Response.md +26 -0
- package/docs/BrandingIndex401Response.md +26 -0
- package/docs/BrandingMenuInner.md +24 -0
- package/docs/BrandingSocial.md +28 -0
- package/docs/BrandingUpdate200Response.md +26 -0
- package/docs/BrandingUpdate400Response.md +26 -0
- package/docs/BrandingUpdate401Response.md +26 -0
- package/docs/ConfigWebhook200Response.md +26 -0
- package/docs/ConfigWebhook400Response.md +26 -0
- package/docs/ConfigWebhook401Response.md +26 -0
- package/docs/ConfigWebhookRequest.md +22 -0
- package/docs/ConfigsIndex200Response.md +26 -0
- package/docs/ConfigsIndex400Response.md +26 -0
- package/docs/ConfigsIndex401Response.md +26 -0
- package/docs/Content.md +28 -0
- package/docs/ContentApi.md +129 -0
- package/docs/ContentCreate200Response.md +26 -0
- package/docs/ContentCreate400Response.md +26 -0
- package/docs/ContentCreate401Response.md +26 -0
- package/docs/ContentIndex200Response.md +26 -0
- package/docs/ContentIndex400Response.md +26 -0
- package/docs/ContentIndex401Response.md +26 -0
- package/docs/Coupon.md +36 -0
- package/docs/CouponProductsInner.md +26 -0
- package/docs/CouponWebhookError.md +26 -0
- package/docs/CouponWebhookErrorContent.md +38 -0
- package/docs/CouponWebhookErrorContentAllOfErrors.md +22 -0
- package/docs/CouponWebhookSuccess.md +26 -0
- package/docs/CouponsApi.md +311 -0
- package/docs/CouponsCreate200Response.md +26 -0
- package/docs/CouponsCreate401Response.md +26 -0
- package/docs/CouponsCreate409Response.md +26 -0
- package/docs/CouponsCreateRequest.md +20 -0
- package/docs/CouponsDelete200Response.md +26 -0
- package/docs/CouponsDelete400Response.md +26 -0
- package/docs/CouponsDelete401Response.md +26 -0
- package/docs/CouponsIndex200Response.md +28 -0
- package/docs/CouponsIndex200ResponseContentInner.md +38 -0
- package/docs/CouponsIndex400Response.md +26 -0
- package/docs/CouponsIndex401Response.md +26 -0
- package/docs/CouponsUpdate201Response.md +26 -0
- package/docs/CouponsUpdate401Response.md +26 -0
- package/docs/CouponsUpdate409Response.md +26 -0
- package/docs/CuponsWebhookRequest.md +26 -0
- package/docs/DocumentRulesApi.md +173 -0
- package/docs/DocumentRulesIndex200Response.md +26 -0
- package/docs/DocumentRulesIndex200ResponseContent.md +24 -0
- package/docs/DocumentRulesIndex200ResponseContentRegulationsInner.md +24 -0
- package/docs/DocumentRulesIndex400Response.md +26 -0
- package/docs/DocumentRulesIndex401Response.md +26 -0
- package/docs/DocumentRulesRegulationDelete200Response.md +24 -0
- package/docs/DocumentRulesRegulationDelete400Response.md +26 -0
- package/docs/DocumentRulesRegulationDelete401Response.md +26 -0
- package/docs/DocumentRulesUpdate200Response.md +26 -0
- package/docs/DocumentRulesUpdate400Response.md +26 -0
- package/docs/DocumentRulesUpdate401Response.md +26 -0
- package/docs/DocumentRulesUpdateRequest.md +24 -0
- package/docs/DocumentRulesUpdateRequestRegulationsInner.md +24 -0
- package/docs/FAQApi.md +236 -0
- package/docs/FaqCreate200Response.md +26 -0
- package/docs/FaqCreate400Response.md +26 -0
- package/docs/FaqCreate401Response.md +26 -0
- package/docs/FaqCreateRequestInner.md +22 -0
- package/docs/FaqDelete200Response.md +26 -0
- package/docs/FaqDelete400Response.md +26 -0
- package/docs/FaqDelete401Response.md +26 -0
- package/docs/FaqIndex200Response.md +28 -0
- package/docs/FaqIndex200ResponseContentInner.md +22 -0
- package/docs/FaqIndex400Response.md +26 -0
- package/docs/FaqIndex401Response.md +26 -0
- package/docs/FaqUpdate200Response.md +26 -0
- package/docs/FaqUpdate400Response.md +26 -0
- package/docs/FaqUpdate401Response.md +26 -0
- package/docs/FilesApi.md +56 -0
- package/docs/Login200Response.md +24 -0
- package/docs/Login401Response.md +20 -0
- package/docs/LoginRequest.md +22 -0
- package/docs/LuckyNumber.md +32 -0
- package/docs/LuckyNumbersAddCustom200Response.md +26 -0
- package/docs/LuckyNumbersAddCustom400Response.md +26 -0
- package/docs/LuckyNumbersAddCustom401Response.md +26 -0
- package/docs/LuckyNumbersApi.md +202 -0
- package/docs/LuckyNumbersRemove200Response.md +26 -0
- package/docs/LuckyNumbersRemove400Response.md +26 -0
- package/docs/LuckyNumbersRemove401Response.md +26 -0
- package/docs/LuckyNumbersRemoveRequest.md +20 -0
- package/docs/LuckyNumbersRemoveRequestLuckyNumbersInner.md +22 -0
- package/docs/LuckyNumbersSearch200Response.md +28 -0
- package/docs/LuckyNumbersSearch400Response.md +26 -0
- package/docs/LuckyNumbersSearch401Response.md +26 -0
- package/docs/Me200Response.md +28 -0
- package/docs/Me200ResponsePromotionsInner.md +22 -0
- package/docs/Metrics200Response.md +26 -0
- package/docs/Metrics200ResponseContent.md +40 -0
- package/docs/Metrics200ResponseContentUsersInner.md +22 -0
- package/docs/Metrics400Response.md +20 -0
- package/docs/MetricsApi.md +75 -0
- package/docs/Order.md +42 -0
- package/docs/OrderCustomDataInner.md +26 -0
- package/docs/OrdersApi.md +204 -0
- package/docs/OrdersCreate200Response.md +26 -0
- package/docs/OrdersCreate400Response.md +26 -0
- package/docs/OrdersCreate401Response.md +26 -0
- package/docs/OrdersCreateRequest.md +20 -0
- package/docs/OrdersIndex200Response.md +28 -0
- package/docs/OrdersIndex400Response.md +26 -0
- package/docs/OrdersIndex401Response.md +26 -0
- package/docs/OrdersUpdate200Response.md +26 -0
- package/docs/OrdersUpdate400Response.md +26 -0
- package/docs/OrdersUpdate401Response.md +26 -0
- package/docs/Pagination.md +42 -0
- package/docs/PaginationLinksInner.md +24 -0
- package/docs/Product.md +32 -0
- package/docs/ProductsApi.md +242 -0
- package/docs/ProductsCreate200Response.md +26 -0
- package/docs/ProductsCreate401Response.md +26 -0
- package/docs/ProductsCreate409Response.md +26 -0
- package/docs/ProductsCreateRequest.md +20 -0
- package/docs/ProductsDelete200Response.md +26 -0
- package/docs/ProductsDelete400Response.md +26 -0
- package/docs/ProductsDelete401Response.md +26 -0
- package/docs/ProductsIndex200Response.md +28 -0
- package/docs/ProductsIndex400Response.md +26 -0
- package/docs/ProductsIndex401Response.md +26 -0
- package/docs/ProductsUpdate201Response.md +26 -0
- package/docs/ProductsUpdate401Response.md +26 -0
- package/docs/ProductsUpdate409Response.md +26 -0
- package/docs/Promotion.md +34 -0
- package/docs/PromotionDataApi.md +60 -0
- package/docs/PromotionDatetime.md +28 -0
- package/docs/PromotionDatetimeActive.md +22 -0
- package/docs/PromotionDatetimeDelivery.md +20 -0
- package/docs/PromotionDatetimeParticipate.md +22 -0
- package/docs/PromotionDatetimeShowAwardeds.md +20 -0
- package/docs/Raffle.md +44 -0
- package/docs/RafflesApi.md +309 -0
- package/docs/RafflesCreate200Response.md +26 -0
- package/docs/RafflesCreate400Response.md +26 -0
- package/docs/RafflesCreate401Response.md +26 -0
- package/docs/RafflesCreateRequestInner.md +30 -0
- package/docs/RafflesDelete200Response.md +26 -0
- package/docs/RafflesDelete400Response.md +26 -0
- package/docs/RafflesDelete401Response.md +26 -0
- package/docs/RafflesIndex200Response.md +28 -0
- package/docs/RafflesIndex400Response.md +26 -0
- package/docs/RafflesIndex401Response.md +26 -0
- package/docs/RafflesReportRequest.md +20 -0
- package/docs/RafflesUpdate200Response.md +26 -0
- package/docs/RafflesUpdate400Response.md +26 -0
- package/docs/RafflesUpdate401Response.md +26 -0
- package/docs/RafflesUpdateRequestInner.md +32 -0
- package/docs/SerieNumber.md +24 -0
- package/docs/SettingsApi.md +65 -0
- package/docs/Store.md +38 -0
- package/docs/StoresApi.md +242 -0
- package/docs/StoresCreate200Response.md +26 -0
- package/docs/StoresCreate401Response.md +26 -0
- package/docs/StoresCreate409Response.md +26 -0
- package/docs/StoresCreateRequest.md +20 -0
- package/docs/StoresDelete200Response.md +26 -0
- package/docs/StoresDelete400Response.md +26 -0
- package/docs/StoresDelete401Response.md +26 -0
- package/docs/StoresIndex200Response.md +28 -0
- package/docs/StoresIndex400Response.md +26 -0
- package/docs/StoresIndex401Response.md +26 -0
- package/docs/StoresUpdate201Response.md +26 -0
- package/docs/StoresUpdate401Response.md +26 -0
- package/docs/StoresUpdate409Response.md +26 -0
- package/docs/Ticket.md +48 -0
- package/docs/TicketsApi.md +249 -0
- package/docs/TicketsCreate200Response.md +26 -0
- package/docs/TicketsCreate400Response.md +26 -0
- package/docs/TicketsCreate401Response.md +26 -0
- package/docs/TicketsDelete200Response.md +26 -0
- package/docs/TicketsDelete400Response.md +26 -0
- package/docs/TicketsDelete401Response.md +26 -0
- package/docs/TicketsIndex200Response.md +28 -0
- package/docs/TicketsIndex400Response.md +26 -0
- package/docs/TicketsIndex401Response.md +26 -0
- package/docs/TicketsUpdate200Response.md +26 -0
- package/docs/TicketsUpdate400Response.md +26 -0
- package/docs/User.md +56 -0
- package/docs/UserCustomData.md +24 -0
- package/docs/UserWebhookError.md +26 -0
- package/docs/UserWebhookErrorContent.md +58 -0
- package/docs/UserWebhookErrorContentAllOfErrors.md +22 -0
- package/docs/UserWebhookSuccess.md +26 -0
- package/docs/UsersApi.md +304 -0
- package/docs/UsersCreate201Response.md +26 -0
- package/docs/UsersCreate401Response.md +26 -0
- package/docs/UsersCreate409Response.md +26 -0
- package/docs/UsersCreateRequest.md +20 -0
- package/docs/UsersDelete200Response.md +26 -0
- package/docs/UsersDelete400Response.md +26 -0
- package/docs/UsersDelete401Response.md +26 -0
- package/docs/UsersIndex200Response.md +28 -0
- package/docs/UsersUpdate201Response.md +26 -0
- package/docs/UsersWebhook200Response.md +20 -0
- package/docs/UsersWebhookRequest.md +26 -0
- package/git_push.sh +57 -0
- package/index.ts +18 -0
- package/package.json +31 -0
- package/tsconfig.json +21 -0
package/base.ts
ADDED
|
@@ -0,0 +1,98 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Plataforma de Promoção - Documentação da API
|
|
5
|
+
* # Introdução Bem-vindo à documentação oficial da API da Plataforma de Promoção IdPlugger! Esta API foi desenvolvida para oferecer acesso seguro e eficiente aos recursos e serviços essenciais da Plataforma. # Sobre a API Esta API é baseada em REST, proporcionando uma arquitetura flexível e de fácil integração para desenvolvedores e empresas. Esta documentação foi elaborada com o intuito de fornecer uma referência abrangente e detalhada para desenvolvedores, parceiros e clientes que desejam utilizar a API da Plataforma de Promoção IdPlugger em seus próprios aplicativos, sistemas e plataformas. Aqui, você encontrará informações sobre os endpoints disponíveis, parâmetros de solicitação, respostas esperadas, autenticação, webhooks, exemplos de uso e muito mais. # Começando Para começar a explorar e utilizar a API da Plataforma de Promoção IdPlugger, recomendamos que você siga os seguintes passos: 1. **Autenticação**: Obtenha suas credenciais de autenticação (\'username\' e \'password\'), junto ao nosso time comercial, para acessar a API. 2. **Explorar Endpoints**: Navegue pela lista de endpoints disponíveis e suas respectivas funcionalidades. 3. **Experimentar**: Utilize os exemplos de solicitação fornecidos para testar os endpoints e compreender melhor seu funcionamento. 4. **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 junto a equipe da Plataforma de Promoção. Este token é do tipo JWT 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 token JWT tem um tempo de validade, o ideal é armazenar o token JWT 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. # Webhooks Ao cadastrar um usuário ou um cupom, a API irá armazenar os dados informados para processar em segundo plano. Por tanto, para obter a informação de cadastro com sucesso ou falha no cadastro de um usuário ou um cupom, é necessário ter um webhook cadastrado na API. Para cadastrar o webhook da promoção na API, utilize o endpoint <a href=\"#/Settings/config.webhook\">`/webhook`</a>. # Ambiente de testes Atualmente a Plataforma de Promoção IdPlugger não possui ambiente de homologação para testes de integração do cliente. Todos as validações devem ser realizadas em produção, **sem ônus à pessoa desenvolvedora**. Todos os dados de testes serão excluídos da Plataforma antes do início oficial da Promoção. Estamos empolgados por você ter escolhido a API de Promoção da IdPlugger para impulsionar suas iniciativas promocionais. Se surgirem dúvidas ou precisar de suporte, não hesite em contatar nossa equipe de suporte técnico. Vamos começar a promover o sucesso juntos! # Postman Collection [<img src=\"https://run.pstmn.io/button.svg\" alt=\"Run In \" style=\"width: 128px; height: 32px;\">](https://god.gw.postman.com/run-collection/13619232-20687020-3c58-488d-bd15-9f9d1a8164b1?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D13619232-20687020-3c58-488d-bd15-9f9d1a8164b1%26entityType%3Dcollection%26workspaceId%3Df86d7ea0-5224-4351-bf69-54ada2ca328d)
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 3.3.0
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
import type { Configuration } from './configuration';
|
|
17
|
+
// Some imports not used depending on template conditions
|
|
18
|
+
// @ts-ignore
|
|
19
|
+
import type { AxiosPromise, AxiosInstance, RawAxiosRequestConfig } from 'axios';
|
|
20
|
+
import globalAxios from 'axios';
|
|
21
|
+
|
|
22
|
+
export const BASE_PATH = "http://localhost".replace(/\/+$/, "");
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
*
|
|
26
|
+
* @export
|
|
27
|
+
*/
|
|
28
|
+
export const COLLECTION_FORMATS = {
|
|
29
|
+
csv: ",",
|
|
30
|
+
ssv: " ",
|
|
31
|
+
tsv: "\t",
|
|
32
|
+
pipes: "|",
|
|
33
|
+
};
|
|
34
|
+
|
|
35
|
+
/**
|
|
36
|
+
*
|
|
37
|
+
* @export
|
|
38
|
+
* @interface RequestArgs
|
|
39
|
+
*/
|
|
40
|
+
export interface RequestArgs {
|
|
41
|
+
url: string;
|
|
42
|
+
options: RawAxiosRequestConfig;
|
|
43
|
+
}
|
|
44
|
+
|
|
45
|
+
/**
|
|
46
|
+
*
|
|
47
|
+
* @export
|
|
48
|
+
* @class BaseAPI
|
|
49
|
+
*/
|
|
50
|
+
export class BaseAPI {
|
|
51
|
+
protected configuration: Configuration | undefined;
|
|
52
|
+
|
|
53
|
+
constructor(configuration?: Configuration, protected basePath: string = BASE_PATH, protected axios: AxiosInstance = globalAxios) {
|
|
54
|
+
if (configuration) {
|
|
55
|
+
this.configuration = configuration;
|
|
56
|
+
this.basePath = configuration.basePath ?? basePath;
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
};
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
*
|
|
63
|
+
* @export
|
|
64
|
+
* @class RequiredError
|
|
65
|
+
* @extends {Error}
|
|
66
|
+
*/
|
|
67
|
+
export class RequiredError extends Error {
|
|
68
|
+
constructor(public field: string, msg?: string) {
|
|
69
|
+
super(msg);
|
|
70
|
+
this.name = "RequiredError"
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
interface ServerMap {
|
|
75
|
+
[key: string]: {
|
|
76
|
+
url: string,
|
|
77
|
+
description: string,
|
|
78
|
+
}[];
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
/**
|
|
82
|
+
*
|
|
83
|
+
* @export
|
|
84
|
+
*/
|
|
85
|
+
export const operationServerMap: ServerMap = {
|
|
86
|
+
"CouponsApi.cuponsWebhook": [
|
|
87
|
+
{
|
|
88
|
+
url: "https://api.example.com/",
|
|
89
|
+
description: "URL do servidor do cliente",
|
|
90
|
+
}
|
|
91
|
+
],
|
|
92
|
+
"UsersApi.usersWebhook": [
|
|
93
|
+
{
|
|
94
|
+
url: "https://api.example.com/",
|
|
95
|
+
description: "URL do servidor do cliente",
|
|
96
|
+
}
|
|
97
|
+
],
|
|
98
|
+
}
|
package/common.ts
ADDED
|
@@ -0,0 +1,150 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Plataforma de Promoção - Documentação da API
|
|
5
|
+
* # Introdução Bem-vindo à documentação oficial da API da Plataforma de Promoção IdPlugger! Esta API foi desenvolvida para oferecer acesso seguro e eficiente aos recursos e serviços essenciais da Plataforma. # Sobre a API Esta API é baseada em REST, proporcionando uma arquitetura flexível e de fácil integração para desenvolvedores e empresas. Esta documentação foi elaborada com o intuito de fornecer uma referência abrangente e detalhada para desenvolvedores, parceiros e clientes que desejam utilizar a API da Plataforma de Promoção IdPlugger em seus próprios aplicativos, sistemas e plataformas. Aqui, você encontrará informações sobre os endpoints disponíveis, parâmetros de solicitação, respostas esperadas, autenticação, webhooks, exemplos de uso e muito mais. # Começando Para começar a explorar e utilizar a API da Plataforma de Promoção IdPlugger, recomendamos que você siga os seguintes passos: 1. **Autenticação**: Obtenha suas credenciais de autenticação (\'username\' e \'password\'), junto ao nosso time comercial, para acessar a API. 2. **Explorar Endpoints**: Navegue pela lista de endpoints disponíveis e suas respectivas funcionalidades. 3. **Experimentar**: Utilize os exemplos de solicitação fornecidos para testar os endpoints e compreender melhor seu funcionamento. 4. **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 junto a equipe da Plataforma de Promoção. Este token é do tipo JWT 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 token JWT tem um tempo de validade, o ideal é armazenar o token JWT 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. # Webhooks Ao cadastrar um usuário ou um cupom, a API irá armazenar os dados informados para processar em segundo plano. Por tanto, para obter a informação de cadastro com sucesso ou falha no cadastro de um usuário ou um cupom, é necessário ter um webhook cadastrado na API. Para cadastrar o webhook da promoção na API, utilize o endpoint <a href=\"#/Settings/config.webhook\">`/webhook`</a>. # Ambiente de testes Atualmente a Plataforma de Promoção IdPlugger não possui ambiente de homologação para testes de integração do cliente. Todos as validações devem ser realizadas em produção, **sem ônus à pessoa desenvolvedora**. Todos os dados de testes serão excluídos da Plataforma antes do início oficial da Promoção. Estamos empolgados por você ter escolhido a API de Promoção da IdPlugger para impulsionar suas iniciativas promocionais. Se surgirem dúvidas ou precisar de suporte, não hesite em contatar nossa equipe de suporte técnico. Vamos começar a promover o sucesso juntos! # Postman Collection [<img src=\"https://run.pstmn.io/button.svg\" alt=\"Run In \" style=\"width: 128px; height: 32px;\">](https://god.gw.postman.com/run-collection/13619232-20687020-3c58-488d-bd15-9f9d1a8164b1?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D13619232-20687020-3c58-488d-bd15-9f9d1a8164b1%26entityType%3Dcollection%26workspaceId%3Df86d7ea0-5224-4351-bf69-54ada2ca328d)
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 3.3.0
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
import type { Configuration } from "./configuration";
|
|
17
|
+
import type { RequestArgs } from "./base";
|
|
18
|
+
import type { AxiosInstance, AxiosResponse } from 'axios';
|
|
19
|
+
import { RequiredError } from "./base";
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
*
|
|
23
|
+
* @export
|
|
24
|
+
*/
|
|
25
|
+
export const DUMMY_BASE_URL = 'https://example.com'
|
|
26
|
+
|
|
27
|
+
/**
|
|
28
|
+
*
|
|
29
|
+
* @throws {RequiredError}
|
|
30
|
+
* @export
|
|
31
|
+
*/
|
|
32
|
+
export const assertParamExists = function (functionName: string, paramName: string, paramValue: unknown) {
|
|
33
|
+
if (paramValue === null || paramValue === undefined) {
|
|
34
|
+
throw new RequiredError(paramName, `Required parameter ${paramName} was null or undefined when calling ${functionName}.`);
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/**
|
|
39
|
+
*
|
|
40
|
+
* @export
|
|
41
|
+
*/
|
|
42
|
+
export const setApiKeyToObject = async function (object: any, keyParamName: string, configuration?: Configuration) {
|
|
43
|
+
if (configuration && configuration.apiKey) {
|
|
44
|
+
const localVarApiKeyValue = typeof configuration.apiKey === 'function'
|
|
45
|
+
? await configuration.apiKey(keyParamName)
|
|
46
|
+
: await configuration.apiKey;
|
|
47
|
+
object[keyParamName] = localVarApiKeyValue;
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
|
|
51
|
+
/**
|
|
52
|
+
*
|
|
53
|
+
* @export
|
|
54
|
+
*/
|
|
55
|
+
export const setBasicAuthToObject = function (object: any, configuration?: Configuration) {
|
|
56
|
+
if (configuration && (configuration.username || configuration.password)) {
|
|
57
|
+
object["auth"] = { username: configuration.username, password: configuration.password };
|
|
58
|
+
}
|
|
59
|
+
}
|
|
60
|
+
|
|
61
|
+
/**
|
|
62
|
+
*
|
|
63
|
+
* @export
|
|
64
|
+
*/
|
|
65
|
+
export const setBearerAuthToObject = async function (object: any, configuration?: Configuration) {
|
|
66
|
+
if (configuration && configuration.accessToken) {
|
|
67
|
+
const accessToken = typeof configuration.accessToken === 'function'
|
|
68
|
+
? await configuration.accessToken()
|
|
69
|
+
: await configuration.accessToken;
|
|
70
|
+
object["Authorization"] = "Bearer " + accessToken;
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
/**
|
|
75
|
+
*
|
|
76
|
+
* @export
|
|
77
|
+
*/
|
|
78
|
+
export const setOAuthToObject = async function (object: any, name: string, scopes: string[], configuration?: Configuration) {
|
|
79
|
+
if (configuration && configuration.accessToken) {
|
|
80
|
+
const localVarAccessTokenValue = typeof configuration.accessToken === 'function'
|
|
81
|
+
? await configuration.accessToken(name, scopes)
|
|
82
|
+
: await configuration.accessToken;
|
|
83
|
+
object["Authorization"] = "Bearer " + localVarAccessTokenValue;
|
|
84
|
+
}
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
function setFlattenedQueryParams(urlSearchParams: URLSearchParams, parameter: any, key: string = ""): void {
|
|
88
|
+
if (parameter == null) return;
|
|
89
|
+
if (typeof parameter === "object") {
|
|
90
|
+
if (Array.isArray(parameter)) {
|
|
91
|
+
(parameter as any[]).forEach(item => setFlattenedQueryParams(urlSearchParams, item, key));
|
|
92
|
+
}
|
|
93
|
+
else {
|
|
94
|
+
Object.keys(parameter).forEach(currentKey =>
|
|
95
|
+
setFlattenedQueryParams(urlSearchParams, parameter[currentKey], `${key}${key !== '' ? '.' : ''}${currentKey}`)
|
|
96
|
+
);
|
|
97
|
+
}
|
|
98
|
+
}
|
|
99
|
+
else {
|
|
100
|
+
if (urlSearchParams.has(key)) {
|
|
101
|
+
urlSearchParams.append(key, parameter);
|
|
102
|
+
}
|
|
103
|
+
else {
|
|
104
|
+
urlSearchParams.set(key, parameter);
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
}
|
|
108
|
+
|
|
109
|
+
/**
|
|
110
|
+
*
|
|
111
|
+
* @export
|
|
112
|
+
*/
|
|
113
|
+
export const setSearchParams = function (url: URL, ...objects: any[]) {
|
|
114
|
+
const searchParams = new URLSearchParams(url.search);
|
|
115
|
+
setFlattenedQueryParams(searchParams, objects);
|
|
116
|
+
url.search = searchParams.toString();
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
*
|
|
121
|
+
* @export
|
|
122
|
+
*/
|
|
123
|
+
export const serializeDataIfNeeded = function (value: any, requestOptions: any, configuration?: Configuration) {
|
|
124
|
+
const nonString = typeof value !== 'string';
|
|
125
|
+
const needsSerialization = nonString && configuration && configuration.isJsonMime
|
|
126
|
+
? configuration.isJsonMime(requestOptions.headers['Content-Type'])
|
|
127
|
+
: nonString;
|
|
128
|
+
return needsSerialization
|
|
129
|
+
? JSON.stringify(value !== undefined ? value : {})
|
|
130
|
+
: (value || "");
|
|
131
|
+
}
|
|
132
|
+
|
|
133
|
+
/**
|
|
134
|
+
*
|
|
135
|
+
* @export
|
|
136
|
+
*/
|
|
137
|
+
export const toPathString = function (url: URL) {
|
|
138
|
+
return url.pathname + url.search + url.hash
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/**
|
|
142
|
+
*
|
|
143
|
+
* @export
|
|
144
|
+
*/
|
|
145
|
+
export const createRequestFunction = function (axiosArgs: RequestArgs, globalAxios: AxiosInstance, BASE_PATH: string, configuration?: Configuration) {
|
|
146
|
+
return <T = unknown, R = AxiosResponse<T>>(axios: AxiosInstance = globalAxios, basePath: string = BASE_PATH) => {
|
|
147
|
+
const axiosRequestArgs = {...axiosArgs.options, url: (axios.defaults.baseURL ? '' : configuration?.basePath ?? basePath) + axiosArgs.url};
|
|
148
|
+
return axios.request<T, R>(axiosRequestArgs);
|
|
149
|
+
};
|
|
150
|
+
}
|
package/configuration.ts
ADDED
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
/* tslint:disable */
|
|
2
|
+
/* eslint-disable */
|
|
3
|
+
/**
|
|
4
|
+
* Plataforma de Promoção - Documentação da API
|
|
5
|
+
* # Introdução Bem-vindo à documentação oficial da API da Plataforma de Promoção IdPlugger! Esta API foi desenvolvida para oferecer acesso seguro e eficiente aos recursos e serviços essenciais da Plataforma. # Sobre a API Esta API é baseada em REST, proporcionando uma arquitetura flexível e de fácil integração para desenvolvedores e empresas. Esta documentação foi elaborada com o intuito de fornecer uma referência abrangente e detalhada para desenvolvedores, parceiros e clientes que desejam utilizar a API da Plataforma de Promoção IdPlugger em seus próprios aplicativos, sistemas e plataformas. Aqui, você encontrará informações sobre os endpoints disponíveis, parâmetros de solicitação, respostas esperadas, autenticação, webhooks, exemplos de uso e muito mais. # Começando Para começar a explorar e utilizar a API da Plataforma de Promoção IdPlugger, recomendamos que você siga os seguintes passos: 1. **Autenticação**: Obtenha suas credenciais de autenticação (\'username\' e \'password\'), junto ao nosso time comercial, para acessar a API. 2. **Explorar Endpoints**: Navegue pela lista de endpoints disponíveis e suas respectivas funcionalidades. 3. **Experimentar**: Utilize os exemplos de solicitação fornecidos para testar os endpoints e compreender melhor seu funcionamento. 4. **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 junto a equipe da Plataforma de Promoção. Este token é do tipo JWT 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 token JWT tem um tempo de validade, o ideal é armazenar o token JWT 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. # Webhooks Ao cadastrar um usuário ou um cupom, a API irá armazenar os dados informados para processar em segundo plano. Por tanto, para obter a informação de cadastro com sucesso ou falha no cadastro de um usuário ou um cupom, é necessário ter um webhook cadastrado na API. Para cadastrar o webhook da promoção na API, utilize o endpoint <a href=\"#/Settings/config.webhook\">`/webhook`</a>. # Ambiente de testes Atualmente a Plataforma de Promoção IdPlugger não possui ambiente de homologação para testes de integração do cliente. Todos as validações devem ser realizadas em produção, **sem ônus à pessoa desenvolvedora**. Todos os dados de testes serão excluídos da Plataforma antes do início oficial da Promoção. Estamos empolgados por você ter escolhido a API de Promoção da IdPlugger para impulsionar suas iniciativas promocionais. Se surgirem dúvidas ou precisar de suporte, não hesite em contatar nossa equipe de suporte técnico. Vamos começar a promover o sucesso juntos! # Postman Collection [<img src=\"https://run.pstmn.io/button.svg\" alt=\"Run In \" style=\"width: 128px; height: 32px;\">](https://god.gw.postman.com/run-collection/13619232-20687020-3c58-488d-bd15-9f9d1a8164b1?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D13619232-20687020-3c58-488d-bd15-9f9d1a8164b1%26entityType%3Dcollection%26workspaceId%3Df86d7ea0-5224-4351-bf69-54ada2ca328d)
|
|
6
|
+
*
|
|
7
|
+
* The version of the OpenAPI document: 3.3.0
|
|
8
|
+
*
|
|
9
|
+
*
|
|
10
|
+
* NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
|
|
11
|
+
* https://openapi-generator.tech
|
|
12
|
+
* Do not edit the class manually.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
|
|
16
|
+
export interface ConfigurationParameters {
|
|
17
|
+
apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
|
|
18
|
+
username?: string;
|
|
19
|
+
password?: string;
|
|
20
|
+
accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
|
|
21
|
+
basePath?: string;
|
|
22
|
+
serverIndex?: number;
|
|
23
|
+
baseOptions?: any;
|
|
24
|
+
formDataCtor?: new () => any;
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
export class Configuration {
|
|
28
|
+
/**
|
|
29
|
+
* parameter for apiKey security
|
|
30
|
+
* @param name security name
|
|
31
|
+
* @memberof Configuration
|
|
32
|
+
*/
|
|
33
|
+
apiKey?: string | Promise<string> | ((name: string) => string) | ((name: string) => Promise<string>);
|
|
34
|
+
/**
|
|
35
|
+
* parameter for basic security
|
|
36
|
+
*
|
|
37
|
+
* @type {string}
|
|
38
|
+
* @memberof Configuration
|
|
39
|
+
*/
|
|
40
|
+
username?: string;
|
|
41
|
+
/**
|
|
42
|
+
* parameter for basic security
|
|
43
|
+
*
|
|
44
|
+
* @type {string}
|
|
45
|
+
* @memberof Configuration
|
|
46
|
+
*/
|
|
47
|
+
password?: string;
|
|
48
|
+
/**
|
|
49
|
+
* parameter for oauth2 security
|
|
50
|
+
* @param name security name
|
|
51
|
+
* @param scopes oauth2 scope
|
|
52
|
+
* @memberof Configuration
|
|
53
|
+
*/
|
|
54
|
+
accessToken?: string | Promise<string> | ((name?: string, scopes?: string[]) => string) | ((name?: string, scopes?: string[]) => Promise<string>);
|
|
55
|
+
/**
|
|
56
|
+
* override base path
|
|
57
|
+
*
|
|
58
|
+
* @type {string}
|
|
59
|
+
* @memberof Configuration
|
|
60
|
+
*/
|
|
61
|
+
basePath?: string;
|
|
62
|
+
/**
|
|
63
|
+
* override server index
|
|
64
|
+
*
|
|
65
|
+
* @type {number}
|
|
66
|
+
* @memberof Configuration
|
|
67
|
+
*/
|
|
68
|
+
serverIndex?: number;
|
|
69
|
+
/**
|
|
70
|
+
* base options for axios calls
|
|
71
|
+
*
|
|
72
|
+
* @type {any}
|
|
73
|
+
* @memberof Configuration
|
|
74
|
+
*/
|
|
75
|
+
baseOptions?: any;
|
|
76
|
+
/**
|
|
77
|
+
* The FormData constructor that will be used to create multipart form data
|
|
78
|
+
* requests. You can inject this here so that execution environments that
|
|
79
|
+
* do not support the FormData class can still run the generated client.
|
|
80
|
+
*
|
|
81
|
+
* @type {new () => FormData}
|
|
82
|
+
*/
|
|
83
|
+
formDataCtor?: new () => any;
|
|
84
|
+
|
|
85
|
+
constructor(param: ConfigurationParameters = {}) {
|
|
86
|
+
this.apiKey = param.apiKey;
|
|
87
|
+
this.username = param.username;
|
|
88
|
+
this.password = param.password;
|
|
89
|
+
this.accessToken = param.accessToken;
|
|
90
|
+
this.basePath = param.basePath;
|
|
91
|
+
this.serverIndex = param.serverIndex;
|
|
92
|
+
this.baseOptions = {
|
|
93
|
+
...param.baseOptions,
|
|
94
|
+
headers: {
|
|
95
|
+
...param.baseOptions?.headers,
|
|
96
|
+
},
|
|
97
|
+
};
|
|
98
|
+
this.formDataCtor = param.formDataCtor;
|
|
99
|
+
}
|
|
100
|
+
|
|
101
|
+
/**
|
|
102
|
+
* Check if the given MIME is a JSON MIME.
|
|
103
|
+
* JSON MIME examples:
|
|
104
|
+
* application/json
|
|
105
|
+
* application/json; charset=UTF8
|
|
106
|
+
* APPLICATION/JSON
|
|
107
|
+
* application/vnd.company+json
|
|
108
|
+
* @param mime - MIME (Multipurpose Internet Mail Extensions)
|
|
109
|
+
* @return True if the given MIME is JSON, false otherwise.
|
|
110
|
+
*/
|
|
111
|
+
public isJsonMime(mime: string): boolean {
|
|
112
|
+
const jsonMime: RegExp = new RegExp('^(application\/json|[^;/ \t]+\/[^;/ \t]+[+]json)[ \t]*(;.*)?$', 'i');
|
|
113
|
+
return mime !== null && (jsonMime.test(mime) || mime.toLowerCase() === 'application/json-patch+json');
|
|
114
|
+
}
|
|
115
|
+
}
|