Ver a conta, a chave e os limites
GET
https://api.precificador3d.com.br/v1/conta Útil para testar a chave e ver os escopos efetivos (escopos da chave que a pessoa que a criou ainda tem permissão para usar).
cURL
curl "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}`,
},
});
if (!resposta.ok) {
const erro = await resposta.json(); // application/problem+json
throw new Error(`${erro.codigo}: ${erro.detail} (${erro.requisicao_id})`);
}
const dados = 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,
)
resposta.raise_for_status()
dados = resposta.json() Cabeçalhos
If-None-Matchstring- ETag recebida antes. Se nada mudou, a resposta é
304e não gasta a cota mensal. (até 100 caracteres)
Resposta 200
Conta da chave.
Campos da resposta (17)
idstring (uuid)nomestringplanostring- Valores:
bancada,oficina,farm. chaveobjectchave.idstring (uuid)chave.nomestring- (até 60 caracteres)
chave.prefixostring- Início da chave, para reconhecer (nunca a chave inteira).
chave.escoposarray de stringchave.escopos_efetivosarray de string- Escopos da chave que quem a criou ainda pode usar.
chave.expira_emstring (date-time) | nulllimitesobjectlimites.rajada_por_segundointegerlimites.rajada_capacidadeintegerlimites.leitura_por_minutointegerlimites.escrita_por_minutointegerlimites.mesintegerlimites.mes_usadointeger
{
"id": "0b8e4c7a-5d2f-4a8e-9c1b-2f3a4b5c6d7e",
"nome": "Ateliê Exemplo",
"plano": "oficina",
"chave": {
"id": "9a1b2c3d-4e5f-4a6b-8c7d-9e0f1a2b3c4d",
"nome": "Loja Exemplo",
"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": {
"rajada_por_segundo": 2,
"rajada_capacidade": 10,
"leitura_por_minuto": 60,
"escrita_por_minuto": 20,
"mes": 150000,
"mes_usado": 1820
}
} Outras respostas
- 304 Nada mudou desde a ETag informada.
- 401
nao_autenticado: Chave ausente, malformada, desconhecida, revogada ou expirada (a resposta é a mesma para todos os casos). - 403
escopo_insuficiente: Escopo insuficiente, conta bloqueada, módulo desligado ou chave suspensa. - 429
limite_excedido: Limite de uso excedido (rajada, minuto, mês ou requisições simultâneas). - 500
erro_interno: Erro interno. O detalhe fica no log, ligado ao requisicao_id. - 503
indisponivel: API desligada, sob pressão (disjuntor aberto) ou no limite global da plataforma.