HomePlataformaBlog
Referência de API/SDK

Rest API

Parâmetros obrigatórios

Os seguinte parâmetro é obrigatório em todas as requisições:

  • network_name: deve ser enviado uma string com o valor "pt".

Autenticação

Assinando requisições em SHA1

Para que as requisições sejam assinadas, os seguintes parâmetros devem ser adicionados à requisição:

  • sha1_signature: hash SHA1 doAPP_SECRET;
  • platform_api_key: APP_KEY do aplicativo.

Exemplo em Ruby

require 'digest/sha1'
require 'httparty'

def signup
  # Hash SHA1 do APP_SECRET do aplicativo
  signature = Digest::SHA1.hexdigest('APP_SECRET')

  # Requisição de exemplo
  body = { network_name: 'pt', platform_api_key: 'APP_KEY', sha1_signature: signature }

  HTTParty.post('https://login.plataformasocial.com.br/users/portal/<ID>/signup', body: body)
end

response = signup()

Acesso sem referência

Nas requisições que utilizamos a referência do usuário como parâmetro, temos também a alternativa de utilizar o ID social do usuário ou o ID do portal. Normalmente isso acontece quando o site ou aplicativo não salva a referência em sua base de dados.

Para utilizar a plataforma sem usar a referência do usuário na plataforma deve-se passar os seguintes parâmetros:

  • id_type: deve ser enviado uma string com o valor "id";
  • reference: identificador do usuário na Dito.

reference

É a referência que a plataforma da Dito cria para o usuário. Serve como o identificador do usuário dentro da Plataforma Dito.

Quando seu aplicativo ou site não salva essa informação no banco de dados, conseguimos através de um identificador identificar esse usuário dentro da plataforma. Esse identificador normalmente é o ID do usuário na sua base.

Protocolos suportados

  • HTTP
  • HTTPS