Imovel

Qual é a missão do SuperTube?

O SuperTube não cobra pelo anúncio ou qualquer forma de comissionamento sobre o produto vendido. Somos veículo, e não intermediadores. Pretendemos atuar conjuntamente com todos os sites de anúncios como parceiros de negócios e não como concorrentes, nos tornando um grande agregador de conteúdo em vídeo de sites de anúncios. Por este motivo desenvolvemos nossa API* e estamos disponibilizando a tecnologia em Streaming de Vídeo aos nossos parceiros.

O que é o API SuperTube?

Definição: API, de Application Programming Interface (ou Interface de Programação de Aplicativos) é um conjunto de rotinas e padrões estabelecidos pelo SuperTube para utilização de suas funcionalidades de upload e streaming (player) de vídeo - isto é: possibilita que outros Sites e/ou aplicações utilizem seus recursos.

Finalizamos o desenvolvimento da API-SuperTube, portanto qualquer e-business que atue na venda, ou demonstração de produtos e serviços; e queira ter a funcionalidade de Upload vídeo poderá tê-lo sem ter que arcar com as todas as despesas como desenvolvimento, Streamming e Hospedagem. Nossa ideia é fornecer esta tecnologia, permitindo que seus usuários "subam" os vídeos e visualize-os em seu próprio site.

O SuperTube.com.br, acredita no beneficio mútuo desta possível aliança. Deste modo aguardamos sua adesão à nossa API* para que possamos criar uma relação de sucesso.

O que é possível fazer com a API SuperTube:

• - Criar um front end em seu site para que seus usuários possam subir vídeos de produtos e serviços .
• - Adicionar conteúdo dinâmico de vídeo relacionado ao seu site ou aplicativo.

Para se ter acesso as funções da API do SuperTube, é necessário que o usuário/parceiro possua além de um cadastro inicial no SuperTube, uma chave, que é gerada mediante solicitação à gerência de novos negócios backend@supertube.com.br. Cada usuário/parceiro, possuirá uma chave, que funcionará para um único domínio.

Como utilizar a API SuperTube.

Classe Upload.

Para efetuar o upload, o usuário, precisará efetuar dois passos:

1 – Gerar, após os dados preliminares do upload, um arquivo XML, acessível externamente, que conterá os dados do vídeo a ser enviado. O padrão a ser seguido, é:

<xml version="1.0" encoding="UTF-8">
<publicacao>
<produto>
<!-- Informações do vídeo -->
<comunidade_id> ID da Comunidade </comunidade_id>
<titulo> Título do Vídeo </titulo>
<resumo> Resumo do vídeo </resumo>
<descricao> Descrição completa do vídeo</descricao>
<tags> Tags, separadas, por, vírgula </tags>
<!--
Tipo de preço
1 - Institucional (nó valor não é usado)
2 - Fixo (nó valor é lido)
3 - A Combinar (nó valor não é usado)
4 - Parcelado (nó "parcelas" indica a quantidade de parcelas, nó "valor" é o valor da parcela)
5 - Leilão (nó valor indica o Valor de Reserva)
6 - Doação (nó valor não é lido)
-->
<precoTipo> 1 </precoTipo>
<valor> 1000,00 </valor>
<parcelas> 5 </parcelas>
</produto>
</publicacao>


2 – Criar o formulário de upload, tomando o cuidado de setar o método como POST, com os campos a serem enviados para o SuperTube segue o padrão sugerido com os campos obrigatórios, quais quaisquer outros campos, serão ignorados pela aplicação:

<form action="http://api.supertube.com.br/upload/" method="post" enctype="multipart/form-data">
<input type="file" name="data[Parceiro][arquivo]" title="Arquivo" />
<input type="hidden" name="data[Parceiro][chave]" value="CHAVE_API" />
<input type="hidden" name="data[Parceiro][xml]" value="URL_DO_ARQUIVO_XML" />
<input type="hidden" name="data[Parceiro][url_ok]" value="http://MINHA_URL_ARQUIVO_VALIDO/" />
<input type="submit" name="btEnviar" value="Enviar" />
</form>


3 - Após o upload ser concluído com sucesso, ocorrerá um redirecionamento para o endereço citado no campo "data[Parceiro][url_ok]", acrescido da ID atribuída a publicação.
Ex.: se você atribuir o endereço "http://meu.site.com.br/arquivoPublicado.php?produto=" como endereço de retorno, você automáticamente será redirecionado para "http://meu.site.com.br/arquivoPublicado.php?produto=ID_DA_PUBLICAÇÃO"

Classe Produto.

A classe Produto recebe como parâmetro GET ou POST, um inteiro, referente ID do produto, e então é gerada uma saída XML com os dados do mesmo, se existir e estiver habilitado.

Exemplo método GET

http://api.supertube.com.br/produto/?produto=XXX

Classe Vitrines.

A Classe Vitrines, recebe como parâmetro a variável "param", que pode ter três tipos de conteúdo:

- um e-mail: referente ao e-mail de contato do responsável pela Vitrine;
- um Alias de Comunidade (Ex. "motor");
- a ID da Comunidade.

Passado o parâmetro correspondente, é obtido um retorno em formato XML, com todos as Vitrines.
O parâmetro "param" pode se enviado pelo método GET ou POST.

Exemplo de uso listando as Vitrines da Comunidade MotorTube.

http://api.supertube.com.br/vitrines/?param=motor

Classe Comunidades.

A Classe Comunidades apenas retorna uma lista em formato JSON com todas as comunidades ativas.

Exemplo:

http://api.supertube.com.br/comunidades

Classe Update.

Para atualizar os dados do seu produto, existe a classe Update. Ela recebe um POST do formulário, seguindo o mesmo padrão de nomes do XML. Segue abaixo, um exemplo para atualizar os dados básicos de um produto de preço fixo:

<form action="http://api.supertube.com.br/update" method="post">
<label class="input">
Título do Produto
<input type="text" id="LojasProdutoTitulo" name="data[Parceiro][titulo]" />
</label>
<label class="input">
Resumo
<input type="text" id="LojasProdutoResumo" name="data[Parceiro][resumo]" />
</label>
<label class="input">
Descrição do produto
<textarea id="LojasProdutoPost" name="data[Parceiro][post]"></textarea>
</label>
<label class="input">
Preço
<input type="text" id="LojasProdutoValor" name="data[Parceiro][valor]" />
</label>
<label class="input">
Palavras-chave
<input type="text" id="LojasProdutoTags" name="data[Parceiro][tags]" />
</label>
<input type="hidden" name="data[Parceiro][precoTipo]" id="2" />
<input type="hidden" name="data[Parceiro][comunidade_id]" id="2" />
<input type="hidden" name="data[Parceiro][url_ok]" value="http://MINHA_URL_ARQUIVO_VALIDO/" />
<input type="hidden" name="data[Parceiro][produto]" value="ID_DO_PRODUTO" />
<input type="hidden" name="data[Parceiro][chave]" value="CHAVE_API" />
<label class="input">
<input type="submit" value="Enviar" />
</label>
</form>


Obtendo sucesso, ocorrerá um redirecionamento para a url indicada no campo 'url_ok', caso contrário, será ecoada na tela, uma mensagem de erro.