Skip to main content

​
Endpoint

POST https://api.tiny.com.br/api2/tag.alterar.php

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave de autenticação
tagobjectobrigatórioDados com tags a alterar
formatostringobrigatórioFormato do retorno (json)

​
Estrutura do parâmetro “tag”

CampoTipoTamanhoOcorrênciaDescrição
tags[].tag.sequenciainteiro-obrigatórioIdentificador sequencial
tags[].tag.idinteiro-obrigatórioID da tag a localizar
tags[].tag.nomestring50obrigatórioNome da tag
tags[].tag.id_grupointeiro-obrigatórioID do grupo de tags

​
Retorno

CampoTipoOcorrênciaDescrição
retorno.status_processamentointobrigatórioCódigo de status
retorno.statusstringobrigatório”OK” ou “Erro”
retorno.codigo_errointcondicionalCódigo conforme tabela
retorno.registros[].registro.sequenciaintcondicionalSequencial
retorno.registros[].registro.statusstringcondicional”OK” ou “Erro”
retorno.registros[].registro.idintcondicionalID 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"}]
  }
}