Gerenciamento de contas

Os administradores de conta podem usar a API REST da OpenTok para criar e gerenciar projetos individuais em sua conta da OpenTok.

Por exemplo, talvez você queira criar projetos diferentes que correspondam a clientes diferentes. Projetos separados permitem que o OpenTok acompanhe o uso individualmente para cada cliente.

Cada projeto possui seu próprio OpenTok exclusivo projeto Chave da API e projeto API segredo.

Por exemplo, um cliente — a Acme — está utilizando seu serviço. Você pode usar a API REST da OpenTok para criar uma chave de API de projeto da OpenTok e um segredo de API de projeto para esse cliente.

Você pode usar a API REST do OpenTok para realizar as seguintes ações:

• Crie um novo projeto para sua conta do OpenTok
• Suspender uma chave de API de projeto ou reativá-la novamente
• Excluir um projeto
• Obtenha informações sobre um projeto específico ou sobre todos os projetos para criar uma conta
• Gerar um novo segredo de API para um projeto
• Especifique um destino de upload no Amazon S3 ou no Microsoft Azure destino para os arquivos de arquivo de um projeto
• Exclusão de um destino de upload para os arquivos de arquivo de um projeto

Para as seguintes chamadas à API REST, use o no nível da conta Chave e segredo da API. Para obter a chave e o segredo da API no nível da conta, faça login na sua Account da Video API, clique em Configurações da conta no menu à esquerda e, em seguida, em API REST do OpenTok, clique em Visualizar chaves da conta. A chave e o segredo da API no nível da conta estão disponíveis apenas para administradores registrados da sua conta do OpenTok. Use a chave e o segredo da API no nível da conta ao criar o token de autenticação você usa na chamada da API REST:

• Criando um novo projeto para sua conta do OpenTok
• Suspender uma chave de API de projeto ou reativá-la novamente
• Excluindo um projeto
• Obter informações sobre um projeto específico ou sobre todos os projetos para criar uma conta
• Gerando um novo segredo de API para um projeto

A chave e o segredo da API no nível da conta estão disponíveis apenas para administradores registrados da sua conta do OpenTok.

Para outras chamadas à API REST, use a chave e o segredo da API do projeto específico no seu Account. Essas informações estão disponíveis na página “Projeto” do seu Account Account da Video API.

Objeto de detalhes do projeto

Muitas respostas às chamadas da API REST incluem um objeto com detalhes do projeto. Essa parte da resposta JSON contém informações sobre o projeto. Ela está no seguinte formato:

{
  "id":  "12312",
  "secret":  "567890",
  "status": "ACTIVE",
  "name": "Joe Montana",
  "environment": "standard",
  "createdAt": 1414642898000 // A UNIX timestamp (in milliseconds)
}

O objeto “Detalhes do projeto” possui as seguintes propriedades:

• id — A chave da API do projeto OpenTok

• secret — O segredo da API do projeto OpenTok

• status — Se o projeto está ativo ("ACTIVE") ou suspenso ("SUSPENDED"). Veja Suspender ou reativar uma chave de API de projeto.

• name — O nome, caso você tenha especificado um ao criar o projeto; ou uma string vazia, caso não tenha especificado um nome

• environment — Isso está definido para "standard" ou "enterprise", e se refere ao ambiente no qual um projeto está sendo executado. Os parceiros do pacote empresarial têm acesso ao ambiente empresarial. Para obter mais informações, consulte nosso pacotes de suporte página. Caso tenha mais dúvidas, por favor, entre em contato conosco.

• createdAt — A hora em que o projeto foi criado (um timestamp UNIX, em milissegundos)

Por favor, desconsidere quaisquer outras propriedades no objeto de detalhes do projeto.