Site: https://oscbr.com.br/gtinmain
Para fazer uso da API GTIN precisará de um usuário e senha, caso ainda não tenha feito poderá esta fazendo seu cadastro acesssando o link abaixo:
Cadastre-se: https://oscbr.com.br/gtincadastro
O Token gerado será necessário para consumir os endpoints da API GTIN.
-
O tempo de vida de um token gerado é de uma hora. Com isso, é possível realizar um número determinado de requisições nas apis, de acordo com o rate limit de cada api, utilizando um único token.
-
Rate limit: 20 chamadas por minuto para o plano free, que esta em vigor atualmente.
Endpoint de solicitação do token Bearer de acesso.
A requisição foi processada com sucesso.
Media type: application/json
{"token":"eyJhbGciOiAiQUVTMjU2IiwgInR5cCI6ICJKV1QifQ==.eyJpc3MiOiJTMkFURnE4OGdtVEsiLCAiZXhwIjoiMTY4MzUyODg0NiIsICJpYXQiOiIxNjgzNTI4NjY2IiwgInNlY3JldHMiOiJleUp6WldOeVpYUnpJam9pWlhsS2NGcERTVFpKYWtVMVNXbDNaMGx1VGpCWldGSXhZM2xKTmtscVJXbE1RMEZwWkVkc2QySXhPVEZqTTFab1kyMXNka2xxYjJsTlUwbzVJaXdnSW0xa05TSTZJakl3UVRjNU5UQXdNREF3TURBd01EQkdORVl3TVVJd01UWXdNVU5DTURBeUluMD0ifQ==.fLS55zjO9i0/rrjSYiYZbZyB64HGawU53QG9szrF5tT4TpJi6O8Md8sCBiwx9u90CR8mSmo37ovGeZ29vJMrKxtHgSBdI1kI/f+dYAhQ/60DitS9fGN3qIynL+OByhAk6UL1TQTTO2+48wa1ioLtwA+Un1lWDFW0MON55C0a1+z9ZH1Yya8FnoZUk3fMx5Syt4z5ZbeNQVwWrBcS2LGXd8OaDHeTRF70RaNTMW09vRoqgsEWyIOEXs0ZLtPkj70Mzc1QAGfpZ/KSsFIVOovuvf5gu9kV4+b6tVMDyIwn3WEcdEUM39DhPZ3UueQn48mcYASXEs9CZtxjXtcfuXehHike/ULaW2qvuYM7iVDcAPwBuH57LX44zj90oo4JTI1LzkAiedIE61mTS0GYQexl8uWEbD25Hv2smWynuMKt1QxRKBdOdc5abnV0vMu0DJv7go42twLfYSb1u4baZg7vuKCyLrAt"}Com o Token gerado anteriormente agora você pode fazer chamada a api usando o mesmo token até que o mesmo se expire.
Endpoint de solicitação das informações de um determinado produto atravez do seu EAN/GTIN.
A requisição foi processada com sucesso.
Media type: application/json
{
"ean": "7896116900029",
"ean_tipo": "EAN13",
"cest": "",
"ncm": 7133399,
"nome": "FEIJAO CARIOCA KICALDO T1 1KG",
"nome_acento": "FEIJÃO CARIOCA TIPO 1 KICALDO PACOTE 1KG",
"unid_abr": "KG",
"unid_desc": "QUILOGRAMA",
"marca": "KICALDO",
"pais": "BRASIL",
"categoria": "Carioca",
"dh_update": "16/05/2023 22:06:29",
"link_foto": "https://oscbr.com.br:9092/api/gtin/img?gtin=7896116900029"
}Não encontrado
O produto para qual solicitou informaçãoes não foi encontrado em nossas bases de dados.
Media type: application/json
{
"ean": "405",
"ean_tipo": "405",
"cest": "405",
"ncm": 405,
"nome": "405",
"nome_acento": "405",
"unid_abr": "405",
"unid_desc": "405",
"marca": "405",
"pais": "405",
"categoria": "405",
"dh_update": "405",
"link_foto": "405"
}Endpoint de solicitação das informações de um determinado produto atravez do seu EAN/GTIN.
O paramêtro 200 nesse endpoint quando informado s faz com que mesmo não encontrado o produto em nossas bases de dados o retorno seja no código 200.
URL: https://oscbr.com.br:9092/api/gtin/infor?gtin={gtin}&200=s
A requisição foi processada com sucesso.
Media type: application/json
{
"ean": "7896116900029",
"ean_tipo": "EAN13",
"cest": "",
"ncm": 7133399,
"nome": "FEIJAO CARIOCA KICALDO T1 1KG",
"nome_acento": "FEIJÃO CARIOCA TIPO 1 KICALDO PACOTE 1KG",
"unid_abr": "KG",
"unid_desc": "QUILOGRAMA",
"marca": "KICALDO",
"pais": "BRASIL",
"categoria": "Carioca",
"dh_update": "16/05/2023 22:06:29",
"link_foto": "https://oscbr.com.br:9092/api/gtin/img?gtin=7896116900029"
}Não encontrado
O produto para qual solicitou informaçãoes não foi encontrado em nossas bases de dados.
Media type: application/json
{
"ean": "405",
"ean_tipo": "405",
"cest": "405",
"ncm": 405,
"nome": "405",
"nome_acento": "405",
"unid_abr": "405",
"unid_desc": "405",
"marca": "405",
"pais": "405",
"categoria": "405",
"dh_update": "405",
"link_foto": "405"
}Com o Token gerado anteriormente agora você pode fazer chamada a api usando o mesmo token até que o mesmo se expire.
Endpoint de solicitação a imagem do produto
URL: https://oscbr.com.br:9092/api/gtin/img?gtin=7896116900029
Requisição mal formada
A requisição não está de acordo com o formato esperado. Verifique se realmente passou o EAN/GTIN na url da requisição.
Não encontrado
O produto para qual solicitou a imgagem não foi encontrado em nossas bases de dados.
Media type: image/x-png
Endpoint de solicitação a imagem do produto
O paramêtro 200 nesse endpoint quando informado s faz com que mesmo não encontrado o produto em nossas bases de dados o retorno seja no código 200.
URL: https://oscbr.com.br:9092/api/gtin/img?gtin=7896116900029&200=s
Requisição mal formada
A requisição não está de acordo com o formato esperado. Verifique se realmente passou o EAN/GTIN na url da requisição.
Não encontrado
O produto para qual solicitou a imgagem não foi encontrado em nossas bases de dados.
Media type: image/x-png
