Skip to main content

​
Endpoint

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

​
Parâmetros

ParâmetroTipoOcorrênciaDescrição
tokenstringobrigatórioChave gerada para identificar sua empresa
tagobjectobrigatórioDados da tag conforme layout especificado
formatostringobrigatórioFormato do retorno (json)

​
Estrutura do parâmetro “tag”

CampoTipoTamanhoOcorrênciaDescrição
tags[]list-obrigatórioLista de tags
tags[].tag.sequenciainteiro-obrigatórioNúmero sequencial
tags[].tag.nomestring50obrigatórioNome da tag
tags[].tag.id_grupointeiro-obrigatórioIdentificação do grupo de tag

​
Retorno

CampoTipoOcorrênciaDescrição
retorno.status_processamentointobrigatórioStatus processual
retorno.statusstringobrigatório”OK” ou “Erro”
retorno.codigo_errointcondicionalConforme tabela de códigos
retorno.registros[].registro.sequenciaintcondicionalNúmero sequencial
retorno.registros[].registro.statusstringcondicional”OK” ou “Erro”
retorno.registros[].registro.idintcondicionalID da tag criada

​
Exemplo de chamada

$url = 'https://api.tiny.com.br/api2/tag.incluir.php';
$token = 'sua_chave_api';
$data = "token=$token&tag={...}&formato=JSON";
enviarREST($url, $data);

​
Exemplos de retorno

​
Sucesso

{
  "retorno": {
    "status_processamento": 3,
    "status": "OK",
    "registros": [
      {
        "registro": {
          "sequencia": "1",
          "status": "OK",
          "id": "37644487"
        }
      }
    ]
  }
}

​
Erro

{
  "retorno": {
    "status_processamento": 1,
    "status": "Erro",
    "codigo_erro": 2,
    "erros": [{"erro": "token invalido"}]
  }
}