×
Entrar
Experimente grátis
Top

GET/gruposprodutos

  • Atualizado
Seguir

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 link-externo.png

Info- icon-P.png 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 link-externo.png

 

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"
            }
         ]
      ]
   }
}

Artigos relacionados