Alterar Tag API 2.0

Serviço destinado a fazer alteração de Tags.

REST

REST URL

Elemento	Tipo	Ocorrência	Descrição
token	string	obrigatório	Chave gerada para identificar sua empresa
tag ⁽¹⁾	-	obrigatório	Dados do tag conforme layout
formato	string	obrigatório	Formato do retorno (json)

(1) - Layout do parâmetro tag

Elemento	Tipo	Tamanho	Ocorrência	Descrição
tags[ ]	list	-	obrigatório	Elemento raiz utilizado para representar um conjunto de Tags.
tags[ ].tag	object	-	obrigatório	Elemento utilizado para representar uma Tag.
tags[ ].tag.sequencia	inteiro	-	obrigatório	Número sequencial utilizado para identificar cada tag.
tags[ ].tag.id ⁽¹⁾	inteiro	-	obrigatório	Número de identificação da Tag no Tiny.
tags[ ].tag.nome	string	50	obrigatório	Nome da Tag.
tags[ ].tag.id_grupo	inteiro	-	obrigatório	Número de indentificação da Grupo de Tag no Tiny.

(1) - Este campo é utilizado para localizar a tag que será alterada.

Elemento	Tipo	Tamanho	Ocorrência	Descrição
retorno	object	-	obrigatório	Elemento raiz do retorno
retorno.status_processamento	int	-	obrigatório	Conforme tabela "Status de Processamento"
retorno.status	string	-	obrigatório	Contém o status do retorno “OK” ou “Erro”. Para o caso de conter erros estes serão descritos abaixo
retorno.codigo_erro ⁽¹⁾	int	-	condicional	Conforme tabela "Códigos de erro"
retorno.erros[ ] ^{(1) (3)}	list	-	condicional [0..n]	Contém a lista dos erros encontrados.
retorno.erros[ ].erro	string	-	condicional	Mensagem contendo a descrição do erro
retorno.registros[ ] ⁽²⁾	list	-	condicional	Lista de resultados da alteração
retorno.registros[ ].registro ⁽²⁾	object	-	condicional	Elemento utilizado para representar uma Tag.
retorno.registros[ ].registro.sequencia	int	-	condicional	Número sequencial utilizado para identificar cada tag.
retorno.registros[ ].registro.status	string	-	condicional	Contém o status do registro “OK” ou “Erro”. Para o caso de conter erros estes serão descritos abaixo
retorno.registros[ ].registro.codigo_erro	int	-	condicional	Conforme tabela "Códigos de erro"
retorno.registros[ ].registro.erros[ ] ⁽³⁾	list	-	condicional [0..n]	Contém a lista dos erros encontrados.
retorno.registros[ ].registro.erros[ ].erro	string	-	condicional	Mensagem contendo a descrição do erro
retorno.registros[ ].registro.id	int	-	condicional	Número de identificação da Tag no Tiny

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

Exemplos do parâmetro tag em JSON

Exemplos da chamada em REST


$url = 'https://api.tiny.com.br/api2/tag.alterar.php';
$token = 'coloque aqui a sua chave da api';
$tag = '<tags>...</tags>';
$data = "token=$token&tag=$tag&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;
}

Alterar Tag API 2.0

Parâmetros do serviço

(1) - Layout do parâmetro tag

Retorno do serviço

Exemplos do parâmetro tag

Exemplos do parâmetro tag em JSON

Exemplos de chamada da API

Exemplos da chamada em REST

Exemplos de retorno da API

Exemplos do retorno do serviço em JSON

Atendimento

Localização