Documentação da API

Bem-vindo à documentação oficial da API PopStore v2. Nossa API é baseada em REST, utiliza JSON para requisições e respostas, e utiliza códigos de status HTTP padrão.

info

A URL base para todas as requisições é: https://api2.popstore.com.br

Autenticação

A API utiliza autenticação via Bearer Token. Este token identifica sua loja (Store ID) e garante a segurança das transações.

Você deve incluir o token no cabeçalho Authorization de todas as requisições.


                            Authorization: Bearer {sua_api_key}

Criar Produto

POST

Cria um novo produto na loja. Este endpoint permite o cadastro completo, incluindo variações (SKUs), fotos e preços.

POST https://api2.popstore.com.br/products/create

Parâmetros do Body (JSON)

Campo	Tipo	Obrigatório	Descrição
code	string	Sim	Código de referência (SKU pai) único do produto.
name	string	Sim	Nome/Título do produto.
description	string	Não	Descrição detalhada do produto (HTML permitido).
price_cost	float	Não	Preço de custo.
price_whlesale	float	Não	Preço de atacado.
price_retail	float	Não	Preço de varejo.
variants	array	Não	Lista de variações (tamanho/cor). Veja o exemplo.
photos	array	Não	Lista de fotos (URL ou Base64).

Exemplo de Requisição

application/json

"code": "VEST-VERAO-24",
"name": "Vestido Floral Verão",
"description": "<p>Vestido leve 100% viscose.</p>",
"price_cost": 45.00,
"price_wholesale": 90.00,
"price_retail": 189.90,
"weight": "0.350",
"variants": [
  {
    "code": "VEST-VERAO-24-P",
    "ean": "7890000001",
    "color_name": "Vermelho",
    "color_html": "#FF0000",
    "size": "P",
    "stock": 10
  },
  {
    "code": "VEST-VERAO-24-M",
    "ean": "7890000001",
    "color_name": "Vermelho",
    "color_html": "#FF0000",
    "size": "M",
    "stock": 15
  }
],
"photos": [
  {
    "url": "https://site.com/foto1.jpg"
    "width": 800
    "height": 1200
  }
]

check_circle 200 OK

{
  "return": {
    "status": "ok",
    "data": {
      "id": 54821
    }
  }
}

error 400 Bad Request

Ocorre se code ou name estiverem vazios.

{
  "return": {
    "status": "error",
    "error": "code is empty"
  }
}