Endpoint
POST https://api.tiny.com.br/api2/tag.alterar.php
Parâmetros
| Parâmetro | Tipo | Ocorrência | Descrição |
|---|---|---|---|
| token | string | obrigatório | Chave de autenticação |
| tag | object | obrigatório | Dados com tags a alterar |
| formato | string | obrigatório | Formato do retorno (json) |
Estrutura do parâmetro “tag”
| Campo | Tipo | Tamanho | Ocorrência | Descrição |
|---|---|---|---|---|
| tags[].tag.sequencia | inteiro | - | obrigatório | Identificador sequencial |
| tags[].tag.id | inteiro | - | obrigatório | ID da tag a localizar |
| tags[].tag.nome | string | 50 | obrigatório | Nome da tag |
| tags[].tag.id_grupo | inteiro | - | obrigatório | ID do grupo de tags |
Retorno
| Campo | Tipo | Ocorrência | Descrição |
|---|---|---|---|
| retorno.status_processamento | int | obrigatório | Código de status |
| retorno.status | string | obrigatório | ”OK” ou “Erro” |
| retorno.codigo_erro | int | condicional | Código conforme tabela |
| retorno.registros[].registro.sequencia | int | condicional | Sequencial |
| retorno.registros[].registro.status | string | condicional | ”OK” ou “Erro” |
| retorno.registros[].registro.id | int | condicional | ID da tag |
Exemplo de chamada
$url = 'https://api.tiny.com.br/api2/tag.alterar.php';
$data = "token=$token&tag=$tag&formato=JSON";
Exemplos de retorno
Sucesso
{
"retorno": {
"status_processamento": 3,
"status": "OK",
"registros": [
{
"registro": {
"sequencia": "1",
"status": "OK",
"id": "37644544"
}
}
]
}
}
Erro
{
"retorno": {
"status_processamento": 1,
"status": "Erro",
"codigo_erro": 2,
"erros": [{"erro": "token invalido"}]
}
}