Primeiros passos

Em cinco minutos você cria uma chave e faz a primeira chamada. Precisa de um terminal com curl e de quem tenha a permissão de gerenciar integrações na conta (por padrão, os perfis Dono e Gerente).

1. 1

   Crie uma chave no app

   Em Configurações › Integrações, clique em Nova chave, dê um nome (por exemplo, "Loja virtual"), marque só os escopos de que a integração precisa e escolha a expiração. O app pede a sua senha de novo e manda um e-mail ao dono da conta.

   Ateliê ExemploConfigurações › Integrações

   Nova chave de API

   Nome da chave

   Loja virtual

   Escopos

   produtos:lerestoque:lercotacoes:escreverprodutos:custospedidos:escrever

   Expira em

   12 meses

   Pede a sua senha de novoCriar chave

2. 2

   Guarde a chave

   A chave aparece uma vez. Copie e guarde num cofre de senhas ou na variável de ambiente da integração, nunca no código, numa planilha ou no navegador. Se perder, revogue e crie outra.

3. 3

   Faça a primeira chamada

   Mande a chave no cabeçalho Authorization. GET /conta mostra a conta, o plano, os escopos efetivos e os limites: é o jeito mais rápido de conferir se está tudo certo.

   cURLJavaScriptPython

   Copiar

   cURL

   export PC3D_CHAVE='pc3d_live_EXEMPLO_nao_e_uma_chave_real'   # cole a sua chave
   
   curl -sS https://api.precificador3d.com.br/v1/conta \
     -H "Authorization: Bearer $PC3D_CHAVE"

   JavaScript

   const resposta = await fetch('https://api.precificador3d.com.br/v1/conta', {
     headers: { Authorization: `Bearer ${process.env.PC3D_CHAVE}` },
   });
   console.log(resposta.status, await resposta.json());

   Python

   import os
   
   import requests
   
   resposta = requests.get(
       "https://api.precificador3d.com.br/v1/conta",
       headers={"Authorization": f"Bearer {os.environ['PC3D_CHAVE']}"},
       timeout=10,
   )
   print(resposta.status_code, resposta.json())

4. 4

   Confira a resposta

   Status 200 e o nome da sua conta. 401 quer dizer chave errada, revogada ou expirada; 403 conta_bloqueada, que a conta está bloqueada.

   Resposta 200 Copiar

   {
     "id": "0b8e4c7a-5d2f-4a8e-9c1b-2f3a4b5c6d7e",
     "nome": "Ateliê Exemplo",
     "plano": "oficina",
     "chave": {
       "nome": "Loja virtual",
       "prefixo": "pc3d_live_EXEMPLO",
       "escopos": [
         "produtos:ler",
         "estoque:ler",
         "cotacoes:escrever"
       ],
       "escopos_efetivos": [
         "produtos:ler",
         "estoque:ler",
         "cotacoes:escrever"
       ],
       "expira_em": "2027-10-03T12:00:00-03:00"
     },
     "limites": {
       "leitura_por_minuto": 60,
       "escrita_por_minuto": 20,
       "mes": 150000,
       "mes_usado": 1820
     }
   }

5. 5

   Siga para o seu caso

   Liste produtos com preço por canal (Listar produtos), lance saídas de estoque quando a loja vende (Lançar movimento) ou receba um aviso quando a cotação for aprovada (Webhooks).

Esta página em Markdown · llms.txt