Documentação API GTIN V1
A seguir você encontra o passo a passo para utilizar nossa API GTIN.
Os endpoints da API GTIN utilizam a URL base: https://gtin.rscsistemas.com.br
Cadastro e autenticação
Para utilizar a API GTIN, é necessário possuir um usuário e senha. Caso ainda não tenha, faça seu cadastro em: https://gtin.rscsistemas.com.br/cadastro
Obter token Bearer
O token gerado será necessário para consumir os endpoints protegidos da API GTIN.
- O token expira em 1 hora.
- Rate limit: 20 req/min no plano Free.
/oauth/token
Endpoint de solicitação do token Bearer de acesso.
URL: https://gtin.rscsistemas.com.br/oauth/token
Método: POST
Headers obrigatórios
Authorization
Basic <base64_encoded_credentials>
As credenciais username:password devem ser codificadas em Base64 e enviadas no header Authorization.
Accept
application/json
Exemplo cURL
curl -X POST "https://gtin.rscsistemas.com.br/oauth/token" \
-H "Authorization: Basic <base64_encoded_credentials>" \
-H "Accept: application/json"Exemplo JavaScript (fetch)
async function obterToken() {
const res = await fetch("https://gtin.rscsistemas.com.br/oauth/token", {
method: "POST",
headers: {
"Authorization": "Basic <base64_encoded_credentials>",
"Accept": "application/json"
}
});
if (!res.ok) {
const txt = await res.text();
throw new Error(`Falha ao obter token (${res.status}): ${txt}`);
}
const data = await res.json();
return data.token;
}Exemplo Delphi (Indy)
uses IdHTTP, System.SysUtils;
function ObterToken: string;
var
HTTP: TIdHTTP;
Resp: string;
begin
HTTP := TIdHTTP.Create(nil);
try
HTTP.Request.CustomHeaders.Values['Authorization'] := 'Basic <base64_encoded_credentials>';
HTTP.Request.Accept := 'application/json';
Resp := HTTP.Post('https://gtin.rscsistemas.com.br/oauth/token', nil);
Result := Resp;
finally
HTTP.Free;
end;
end;Respostas
Código 200:
A requisição foi processada com sucesso.
Media type: application/json
{ "token": "eyJhbGciOiAiQUVTMjU2IiwgInR5cCI6ICJKV1QifQ==..." }Código 401:
Não autenticado. Verifique suas credenciais.
Media type: application/json
{ "erro": "Não autenticado. Verifique suas credenciais." }Informações do produto
Com o token gerado anteriormente, você pode consultar os dados do produto enviando o header Authorization: Bearer <SEU_TOKEN>.
/api/gtin/infor/:gtin
Endpoint para obter as informações de um produto a partir do seu EAN/GTIN.
URL: https://gtin.rscsistemas.com.br/api/gtin/infor/:gtin
Método: GET
Parâmetros e headers
gtin
string (path)
Authorization
Bearer <SEU_TOKEN>
Accept
application/json
Exemplo cURL
GTIN="7896116900029"
TOKEN="SEU_TOKEN_AQUI"
curl -X GET "https://gtin.rscsistemas.com.br/api/gtin/infor/$GTIN" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json"Exemplo JavaScript (fetch)
async function obterInfoProduto(gtin, token) {
const url = `https://gtin.rscsistemas.com.br/api/gtin/infor/${encodeURIComponent(gtin)}`;
const res = await fetch(url, {
headers: {
"Authorization": `Bearer ${token}`,
"Accept": "application/json"
}
});
if (res.status === 404) {
const err = await res.json();
throw new Error(err.mensagem || "Produto não encontrado");
}
if (!res.ok) {
const txt = await res.text();
throw new Error(`Erro ${res.status}: ${txt}`);
}
return res.json();
}Exemplo Delphi (Indy)
function ObterInfoProduto(const GTIN, Token: string): string;
var
HTTP: TIdHTTP;
URL: string;
begin
HTTP := TIdHTTP.Create(nil);
try
HTTP.Request.CustomHeaders.Values['Authorization'] := 'Bearer ' + Token;
HTTP.Request.Accept := 'application/json';
URL := Format('https://gtin.rscsistemas.com.br/api/gtin/infor/%s', [GTIN]);
Result := HTTP.Get(URL);
finally
HTTP.Free;
end;
end;Respostas
Código 200:
A requisição foi processada com sucesso.
Media type: application/json
{
"ean": "7896116900029",
"ean_tipo": "EAN13",
"ncm": 7133399,
"nome": "FEIJAO CARIOCA KICALDO T1 1KG",
"marca": "KICALDO",
"pais": "BRASIL",
"categoria": "Carioca",
"link_foto": "https://gtin.rscsistemas.com.br/api/gtin/img/7896116900029"
}Código 404:
Produto não encontrado na base de dados.
Media type: application/json
{ "mensagem": "Produto não encontrado na base de dados" }Imagem do produto
Com o token gerado anteriormente, você pode solicitar a imagem do produto informando o GTIN e o header Authorization: Bearer <SEU_TOKEN>.
/api/gtin/img/:gtin
Endpoint para solicitar a imagem do produto.
URL: https://gtin.rscsistemas.com.br/api/gtin/img/:gtin
Método: GET
Parâmetros e headers
gtin
string (path)
Authorization
Bearer <SEU_TOKEN>
Exemplo cURL
GTIN="7896116900029"
TOKEN="SEU_TOKEN_AQUI"
curl -L "https://gtin.rscsistemas.com.br/api/gtin/img/$GTIN" \
-H "Authorization: Bearer $TOKEN" \
--output "${GTIN}.png"Exemplo JavaScript (fetch)
async function baixarImagem(gtin, token) {
const url = `https://gtin.rscsistemas.com.br/api/gtin/img/${encodeURIComponent(gtin)}`;
const res = await fetch(url, {
headers: { "Authorization": `Bearer ${token}` }
});
if (res.status === 404) {
const err = await res.json();
throw new Error(err.mensagem || "Produto não encontrado na base de dados");
}
if (res.status === 204) {
throw new Error("Produto encontrado, porem sem imagem cadastrada");
}
if (!res.ok) {
const txt = await res.text();
throw new Error(`Erro ${res.status}: ${txt}`);
}
const blob = await res.blob();
const urlBlob = URL.createObjectURL(blob);
const a = document.createElement("a");
a.href = urlBlob;
a.download = `${gtin}.png`;
a.click();
URL.revokeObjectURL(urlBlob);
}Exemplo Delphi (Indy)
procedure BaixarImagem(const GTIN, Token, CaminhoDestino: string);
var
HTTP: TIdHTTP;
FileStream: TFileStream;
URL: string;
begin
HTTP := TIdHTTP.Create(nil);
try
HTTP.Request.CustomHeaders.Values['Authorization'] := 'Bearer ' + Token;
URL := Format('https://gtin.rscsistemas.com.br/api/gtin/img/%s', [GTIN]);
FileStream := TFileStream.Create(CaminhoDestino + GTIN + '.png', fmCreate);
try
HTTP.Get(URL, FileStream);
finally
FileStream.Free;
end;
finally
HTTP.Free;
end;
end;Respostas
Código 200:
A requisição foi processada com sucesso.
Media type: image/png
Exemplo de imagem retornada.
Código 404:
Produto não encontrado na base de dados.
Media type: application/json
{ "mensagem": "Produto não encontrado na base de dados" }Código 204:
Produto encontrado, porém sem imagem cadastrada.
Imagem de exemplo para retorno 204 No Content.
Boas práticas
- Sempre envie o header
Authorization: Bearer <token>nos endpoints protegidos. - Trate a expiração do token solicitando um novo em
/oauth/token. - Valide o GTIN localmente antes de consultar.
- Utilize
Accept: application/jsonpara respostas estruturadas.