vinicosta-p / lojatech

Api para e-commerce dropshipping

Sobre

Essa é uma API que gerencia os cadastros de produtos e-commerce com a técnica de dropshipping. Com ela é possível fazer cadastros de produtos em estoque ou um produto da Aliexpress apenas passando o ID e informações extras do produto.

Tabela de conteúdos

• Sobre
• Tecnologias
• Como usar
  • Pré Requisitos
  • Rodando a aplicação
  • API Endpoints

Tecnologias

   

Esse projeto é uma API utiliza **Java, Java Spring, Flyway Migrations e PostgresSQL para armazenamento dos produtos.

Como usar

Pré Requisitos

Você vai precisar ter instalado em sua máquina as seguintes ferramentas:

• Git
• PostgresSQL
• Java 17 ou melhor
• Maven

Preferencialmente utilizar a IDE Visual Studio Code.

Também é necessário uma conta, se inscrever na API Aliexpress DataHub APIe guardar a chave no projeto.

Rodando a aplicação

1. Clone o repositório

git clone https://github.com/vinicosta-p/lojatech.git

2. Instale as dependências do Maven

3. Dentro do projeto crie um arquivo com o nome application.properties dentro do path lojatech\src\main\resources com os seguintes parametros

#database

spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect
spring.datasource.driverClassName=org.postgresql.Driver
spring.datasource.url=jdbc:postgresql://localhost:5432/lojatech
spring.datasource.username=INSIRA O USERNAME POSTGRES
spring.datasource.password=INSIRA A SENHA DO POSTGRES

#Env
api.key=${API_KEY:COLOQUE SUA CHAVE DA API ALIEXPRESS DATAHUB}

4. Rode a aplicação apertando F5 ou execute o arquivo lojatech\src\main\java\com\pecastech\app\AppApplication.java

5. A API está acessível na no endereço http://localhost:8080

API Endpoints

PRODUTO

A api product é possível manipular os produtos em estoque como adicionar, alterar, deletar e mostrar todos os produtos disponíveis.

API PRODUCT

POST /api/product - Create a new product  
GET /api/product - Retrieve all products 
PUT /api/product/{id} - Updates a product  
DELETE /api/product/{id} - Delete a product  

BODY

{
	"ownerId":"0004", // ID dado pelo admnistrador
    "name":"Marca - Nome do produto", 
	"category":"Perfume",
	"shopId":"38123021", // ID de produtos da aliexpress
	"price":100000, // preço em centavos
	"promotionPrice": 90000,
	"description":"Este produto possui funcionalidades",
	"image":"https//",
	"quantity": 100
}

ERROR

{
	"timestamp":"Fri May 24 21:38:41 BRT 2024",
	"status":"Error",
	"code":404,
	"stausCode":"Not found",
	"messageError":"Product not found try another id"
}

DROPSHIPPING

Nesse endpoint é possível adicionar um produto da Aliexpress apenas com o id do produto na loja online.

API ALIEXPRESS

POST /api/product/aliexpress - Create a new product by aliexpress

REQUEST BODY

{
    "ownerID":"004",
    "price":4000,
	"category":"Jogos",
	"promotionPrice":3000 
}

RESPONSE BODY

{
	"ownerId":"0004", // ID dado pelo admnistrador
    "name":"Marca - Nome do produto", 
	"category":"Perfume",
	"shopId":"38123021", // ID de produtos da aliexpress
	"price":100000, // preço em centavos
	"promotionPrice": 90000,
	"description":"Este produto possui funcionalidades",
	"image":"https//",
	"quantity": 100
}