Documentação da API

URL base

Autenticação (obrigatória)

Toda chamada à API precisa de um token pessoal - é assim que garantimos um limite de uso estável pra quem está integrando de verdade (seu ERP, PDV ou e-commerce). Crie uma conta gratuita com o Google e gere um token na sua página de conta — o limite é de 100 requisições por hora por token, suficiente pra uma consulta manual de produtos (bipar código, ver os dados, próximo). Envie o token no cabeçalho Authorization em toda requisição:

Buscar produtos

GET /api/produtos

Parâmetros de query:

Exemplo de código:

<?php

$query = http_build_query([
    'q' => 'sabonete ype',
    'per_page' => 5,
]);

$ch = curl_init("https://global.si5.com.br/api/produtos?{$query}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SEU_TOKEN_AQUI',
]);

$resposta = curl_exec($ch);
$codigo = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$dados = json_decode($resposta, true);

foreach ($dados['data'] as $produto) {
    echo $produto['produto'] . ' - ' . $produto['marca'] . PHP_EOL;
}

uses
  IdHTTP, IdSSLOpenSSL, System.JSON, System.SysUtils;

function BuscarProdutos(const ATermo: string; APorPagina: Integer = 5): TJSONObject;
var
  Http: TIdHTTP;
  SSL: TIdSSLIOHandlerSocketOpenSSL;
  Url, Resposta: string;
begin
  Http := TIdHTTP.Create(nil);
  SSL := TIdSSLIOHandlerSocketOpenSSL.Create(nil);
  try
    Http.IOHandler := SSL;
    Http.Request.CustomHeaders.AddValue('Authorization', 'Bearer SEU_TOKEN_AQUI');

    Url := Format('https://global.si5.com.br/api/produtos?q=%s&per_page=%d',
      [TIdURI.ParamsEncode(ATermo), APorPagina]);

    Resposta := Http.Get(Url);
    Result := TJSONObject.ParseJSONValue(Resposta) as TJSONObject;
  finally
    Http.Free;
    SSL.Free;
  end;
end;

// uso:
// var Json: TJSONObject;
// Json := BuscarProdutos('sabonete ype');
// try
//   // Json.GetValue<TJSONArray>('data') ...
// finally
//   Json.Free;
// end;

Exemplo de resposta:

{
  "data": [
    {
      "codbar": "7896098900475",
      "produto": "Sabonete Em Barra Flor De Ypê Laranjeira E Damasco Ypê 90g",
      "marca": "YPÊ",
      "categoria": "Higiene E Beleza",
      "ncm": "34011190",
      "cest_codigo": "2001700",
      "peso": "90.00",
      "embalagem": null,
      "quantidade_embalagem": 1,
      "preco_medio": null,
      "imagem_url": "https://global.si5.com.br/img/webp/7896098900475.webp",
      "codigo_barras_url": null
    }
  ],
  "meta": { "current_page": 1, "last_page": 214, "total": 26 }
}

Consultar um produto pelo código de barras

GET /api/produtos/{'{codbar}'}

Exemplo de código:

<?php

$codbar = '7891000100103';

$ch = curl_init("https://global.si5.com.br/api/produtos/{$codbar}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer SEU_TOKEN_AQUI',
]);

$resposta = curl_exec($ch);
$codigo = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($codigo === 404) {
    echo "Produto nao encontrado";
} else {
    $produto = json_decode($resposta, true);
    echo $produto['produto'] . ' - NCM ' . $produto['ncm'];
}

uses
  IdHTTP, IdSSLOpenSSL, IdComponent, System.JSON, System.SysUtils;

function ConsultarProduto(const ACodBar: string): TJSONObject;
var
  Http: TIdHTTP;
  SSL: TIdSSLIOHandlerSocketOpenSSL;
begin
  Result := nil;
  Http := TIdHTTP.Create(nil);
  SSL := TIdSSLIOHandlerSocketOpenSSL.Create(nil);
  try
    Http.IOHandler := SSL;
    Http.Request.CustomHeaders.AddValue('Authorization', 'Bearer SEU_TOKEN_AQUI');
    try
      Result := TJSONObject.ParseJSONValue(
        Http.Get('https://global.si5.com.br/api/produtos/' + ACodBar)
      ) as TJSONObject;
    except
      on E: EIdHTTPProtocolException do
        if Http.ResponseCode = 404 then
          raise Exception.Create('Produto nao encontrado')
        else
          raise;
    end;
  finally
    Http.Free;
    SSL.Free;
  end;
end;

Campos adicionais nesta resposta:

Erros

A API responde em JSON também nos erros, seguindo o padrão HTTP: