×
Entrar
Experimente grátis
Top

GET /categoria/{idCategoria}

  • 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 uma categoria

Busca uma categoria a partir do seuid

 

curl    

 
 curl -X GET "https://bling.com.br/Api/v2/categoria/{idCategoria}/json/"
      -G
      -d "apikey={apikey}"

PHP

 
 v$idCategoria = "{idCategoria}";
$apikey = "{apikey}";
$outputType = "json";
$url = 'https://bling.com.br/Api/v2/categoria/' . $idCategoria . '/' . $outputType;
$retorno = executeGetCategories($url, $apikey);
echo $retorno;
function executeGetCategories($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 ExecuteGetCategory() {
    var request = HttpWebRequest.Create(@"https://bling.com.br/Api/v2/categoria/{idCategoria}/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    
 
 

Retorno

Em caso de sucesso, retornará a categoria solicitada, 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":  {  
      "categorias":  [  
         {  
            "categoria":{  
               "id": 792,
               "descricao": "Casa, Mesa e Banho",
               "idCategoriaPai": 0
            }
         }
      ]
   }
}

 

Artigos relacionados