Você está usando um navegador que não é suportado pelo Tiny. Saiba mais

Pesquisar Tag API 2.0

Serviço destinado a fazer consulta de Tags.

ElementoTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
formatostringobrigatórioFormato do retorno (json)
pesquisa (1)stringopcionalNome ou parte do nome do grupo de tags que deseja consultar
idGrupo (1)intopcionalNúmero de identificação do grupo de tag no Tiny
pagina (2)intopcionalNúmero da página

(1) - Ao menos um desses parâmetros deve ser informado.
(2) - Número da página que deseja obter (por padrão são listados 100 registros por página), caso não seja informado o valor padrão é 1.

ElementoTipoTamanhoOcorrênciaDescrição
retornoobject-obrigatórioElemento raiz do retorno
retorno.status_processamentoint-obrigatórioConforme tabela "Status de Processamento"
retorno.statusstring-obrigatórioContém o status do retorno “OK” ou “Erro”. Para o caso de conter erros estes serão descritos abaixo
retorno.codigo_erro (1)int-condicionalConforme tabela "Códigos de erro"
retorno.erros[ ] (1) (3)list-condicional [0..n]Contém a lista dos erros encontrados.
retorno.erros[ ].errostring-condicionalMensagem contendo a descrição do erro
retorno.paginaint-obrigatórioNúmero da página que está sendo retornada
retorno.numero_paginasint-obrigatórioNúmero de paginas do retorno
retorno.registros[ ] (2)list-condicionalLista de resultados da pesquisa
retorno.registros[ ].registro (2)object-condicionalElemento utilizado para representar uma Tag.
retorno.registros[ ].registro.idint-condicionalNúmero de identificação da Tag no Tiny
retorno.registros[ ].registro.nomestring50condicionalNome da Tag
retorno.registros[ ].registro.id_grupoint50condicionalNúmero de identificação do Grupo da Tag no Tiny
retorno.registros[ ].registro.grupostring50condicionalNome do Grupo da Tag

(1) - Somente estará presente no retorno caso o elemento "status" seja "Erro".
(2) - Somente estará presente no retorno caso o elemento "status" seja "OK".
(3) - Estes campos somente serão informados caso o retorno contenha erros.


$url = 'https://api.tiny.com.br/api2/tag.pesquisa.php';
$token = 'coloque aqui a sua chave da api';
$pesquisa = 'xxxxx';
$data = "token=$token&pesquisa=$pesquisa&formato=JSON";

enviarREST($url, $data);    

function enviarREST($url, $data, $optional_headers = null) {
	$params = array('http' => array(
		'method' => 'POST',
	    'content' => $data
	));
	
	if ($optional_headers !== null) {
		$params['http']['header'] = $optional_headers;
	}
	
	$ctx = stream_context_create($params);
	$fp = @fopen($url, 'rb', false, $ctx);
	if (!$fp) {
		throw new Exception("Problema com $url, $php_errormsg");
	}
	$response = @stream_get_contents($fp);
	if ($response === false) {
		throw new Exception("Problema obtendo retorno de $url, $php_errormsg");
	}
	
	return $response;
}