A API V3 JÁ ESTÁ DISPONÍVEL
A API v2 foi descontinuada e não receberá mais atualizações.
Acesse a documentação da API v3 
As integrações API v2 que já estão configuradas, seguirão funcionando temporariamente. Realize a migração para a nova versão o mais breve possível. Consulte o calendário 
|
Busca todos os grupos de produtos
Recupera todos os grupos de produtos cadastrados no sistema.
curl |
curl -X GET "https://bling.com.br/Api/v2/gruposprodutos/json/" -G -d "apikey={apikey}"
|
PHP |
$apikey = "{apikey}"; $outputType = "json"; $url = 'https://bling.com.br/Api/v2/gruposprodutos/' . $outputType; $retorno = executeGet($url, $apikey); echo $retorno; function executeGet($url, $apikey){ $curl_handle = curl_init(); curl_setopt($curl_handle, CURLOPT_URL, $url . '&apikey=' . $apikey); curl_setopt($curl_handle, CURLOPT_RETURNTRANSFER, TRUE); $response = curl_exec($curl_handle); curl_close($curl_handle); return $response; }
|
C# |
public static void ExecuteGetProductsGroups() { var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/gruposprodutos/json&apikey={apikey}"); request.ContentType = "application/json"; request.Method = "GET"; using (HttpWebResponse response = request.GetResponse() as HttpWebResponse) { if (response.StatusCode != HttpStatusCode.OK) Console.Out.WriteLine("Error. Server returned status code: {0}", response.StatusCode); using (StreamReader reader = new StreamReader(response.GetResponseStream())) { var content = reader.ReadToEnd(); if(string.IsNullOrWhiteSpace(content)) Console.Out.WriteLine("Empty Response"); else Console.Out.WriteLine("Response Body: \r\n {0}", content); } } }
|
Parâmetro |
Descrição |
Tipo |
apikey |
Sua apikey |
string |
Filtros
Pode-se utilizar filtros para restringir o retorno de dados. Observe a tabela de possíveis filtros abaixo.
Filtro |
Descrição |
Tipo |
Predicate |
nome |
Filtra pelo nome do grupo |
string(120) |
|
nomePai |
Filtra pelo nome do grupo pai |
string(120) |
|
curl -X GET "https://bling.com.br/Api/v2/grupoprodutos/json/"
-G
-d "filters=nome[Celulares];nomePai[Eletrônicos]"
-d "apikey={apikey}"
Retorno
Em caso de sucesso, retornará todos os grupos de produtos registrados, no mesmo modelo do exemplo a seguir. Caso contrário, retornará um erro.
A resposta será no formato especificado na URL (XML ou JSON).
Exemplo de Retorno
{
"retorno":{
"gruposprodutos":[
[
{
"id":"123",
"nome":"Eletrônicos",
"idPai":null,
"nomePai":null
},
{
"id":"124",
"nome":"Celulares",
"idPai":"123",
"nomePai":"Eletrônicos"
},
{
"id":"125",
"nome":"Notebooks",
"idPai":"123",
"nomePai":"Eletrônicos"
}
]
]
}
}