API REST do Serviço do Azure SignalR
Artigo 12/04/2024
1 colaborador
Comentários
Neste artigo
Versão: 2022-06-01
APIs Disponíveis
/api/saúde
HEAD
Resumo
Obtenha o status de integridade do serviço.
Obter status de integridade do serviço
HEAD /api/health
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
Código
Descrição
200
O serviço é saudável
padrão
Resposta de erro
/api/hubs/{hub}/:fecharConexões
POSTAR
Resumo
Feche todas as conexões no hub.
Feche todas as conexões no hub
POST /api/hubs/{hub}/:closeConnections
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
Excluído
consulta
Exclua essas connectionIds ao fechar as conexões no hub.
Não
[ cadeia de caracteres ]
reason
consulta
O motivo que fecha as conexões do cliente.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/:enviar
POSTAR
Resumo
Transmitir uma mensagem para todos os clientes conectados ao hub de destino.
Transmitir uma mensagem para todos os clientes conectados ao hub de destino
POST /api/hubs/{hub}/:send
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
Excluído
consulta
IDs de conexão excluídas
Não
[ cadeia de caracteres ]
api-version
consulta
A versão das APIs REST.
Sim
string
mensagem
body
A mensagem de carga.
Sim
Mensagem de carga
Respostas
/api/hubs/{hub}/connections/{connectionId}
HEAD
Resumo
Verificar se a conexão com a connectionId determinada existe
Verificar se a conexão com a connectionId determinada existe
HEAD /api/hubs/{hub}/connections/{connectionId}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
connectionId
caminho
A ID de conexão.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
DELETE
Resumo
Fechar conexão de cliente
Fechar conexão de cliente
DELETE /api/hubs/{hub}/connections/{connectionId}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
connectionId
caminho
A ID de conexão.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
reason
consulta
O motivo do fechamento da conexão.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/connections/{connectionId}/:enviar
POSTAR
Resumo
Enviar mensagem para a conexão específica.
Enviar mensagem para a conexão específica
POST /api/hubs/{hub}/connections/{connectionId}/:send
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
connectionId
caminho
A ID de conexão.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
mensagem
body
A mensagem de carga.
Sim
Mensagem de carga
Respostas
/api/hubs/{hub}/groups/{group}
HEAD
Resumo
Verificar se há conexões de cliente dentro do grupo determinado
Verificar se há conexões de cliente dentro do grupo determinado
HEAD /api/hubs/{hub}/groups/{group}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/groups/{group}/:closeConnections
POSTAR
Resumo
Feche as conexões no grupo específico.
Fechar conexões no grupo específico
POST /api/hubs/{hub}/groups/{group}/:closeConnections
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
Excluído
consulta
Exclua essas connectionIds ao fechar as conexões no hub.
Não
[ cadeia de caracteres ]
reason
consulta
O motivo que fecha as conexões do cliente.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/groups/{group}/:enviar
POSTAR
Resumo
Transmitir uma mensagem para todos os clientes dentro do grupo de destino.
Transmitir uma mensagem para todos os clientes dentro do grupo de destino
POST /api/hubs/{hub}/groups/{group}/:send
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
Excluído
consulta
IDs de conexão excluídas
Não
[ cadeia de caracteres ]
api-version
consulta
A versão das APIs REST.
Sim
string
mensagem
body
A mensagem de carga.
Sim
Mensagem de carga
Respostas
/api/hubs/{hub}/groups/{group}/connections/{connectionId}
PUT
Resumo
Adicionar uma conexão ao grupo de destino.
Adicionar uma conexão ao grupo de destino
PUT /api/hubs/{hub}/groups/{group}/connections/{connectionId}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
connectionId
caminho
ID da conexão de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
DELETE
Resumo
Remover uma conexão do grupo de destino.
Remover uma conexão do grupo de destino
DELETE /api/hubs/{hub}/groups/{group}/connections/{connectionId}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
connectionId
caminho
ID da conexão de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/connections/{connectionId}/groups
DELETE
Resumo
Remover uma conexão de todos os grupos
Remover uma conexão de todos os grupos
DELETE /api/hubs/{hub}/connections/{connectionId}/groups
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
connectionId
caminho
ID da conexão de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/users/{user}
HEAD
Resumo
Verificar se há conexões de cliente conectadas para o usuário determinado
Verificar se há conexões de cliente conectadas para o usuário determinado
HEAD /api/hubs/{hub}/users/{user}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
usuário
caminho
A ID do usuário.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/users/{user}/:closeConnections
POSTAR
Resumo
Feche as conexões para o usuário específico.
Fechar conexões para o usuário específico
POST /api/hubs/{hub}/users/{user}/:closeConnections
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
usuário
caminho
A ID do usuário.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
Excluído
consulta
Exclua essas connectionIds ao fechar as conexões no hub.
Não
[ cadeia de caracteres ]
reason
consulta
O motivo que fecha as conexões do cliente.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/users/{user}/:enviar
POSTAR
Resumo
Transmitir uma mensagem para todos os clientes pertencentes ao usuário de destino.
Transmitir uma mensagem para todos os clientes pertencentes ao usuário de destino
POST /api/hubs/{hub}/users/{user}/:send
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
usuário
caminho
A ID do usuário.
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
mensagem
body
A mensagem de carga.
Sim
Mensagem de carga
Respostas
/api/hubs/{hub}/users/{user}/groups/{group}
HEAD
Resumo
Verificar se um usuário existe no grupo de destino.
Verificar se existe um usuário no grupo de destino
HEAD /api/hubs/{hub}/users/{user}/groups/{group}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
usuário
caminho
ID do usuário de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
PUT
Resumo
Adicionar um usuário ao grupo de destino.
Adicionar um usuário ao grupo de destino
PUT /api/hubs/{hub}/users/{user}/groups/{group}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
usuário
caminho
ID do usuário de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
ttl
consulta
Especifica os segundos que o usuário existe no grupo. Se não estiver definido, o usuário mora no grupo por no máximo 1 ano. Se um usuário for adicionado a alguns grupos sem limitação de ttl, apenas os 100 grupos atualizados mais recentes serão reservados entre todos os grupos aos quais o usuário ingressou sem TTL. Se ttl = 0, somente as conexões conectadas atuais do usuário de destino serão adicionadas ao grupo de destino.
Não
Número inteiro
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
DELETE
Resumo
Remover um usuário do grupo de destino.
Remover um usuário do grupo de destino
DELETE /api/hubs/{hub}/users/{user}/groups/{group}
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
grupo
caminho
Nome do grupo-alvo, cujo comprimento deve ser maior que 0 e menor que 1025.
Sim
string
usuário
caminho
ID do usuário de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
/api/hubs/{hub}/usuários/{usuário}/grupos
DELETE
Resumo
Remover um usuário de todos os grupos.
Remover um usuário de todos os grupos
DELETE /api/hubs/{hub}/users/{user}/groups
Parâmetros
Nome
Localizado em
Descrição
Necessário
Esquema
hub
caminho
O nome do hub de destino, que deve começar com caracteres alfabéticos e só conter caracteres alfanuméricos ou sublinhado.
Sim
string
usuário
caminho
ID do usuário de destino
Sim
string
aplicativo
consulta
Nome do aplicativo de destino, que deve começar com caracteres alfabéticos e conter apenas caracteres alfanuméricos ou sublinhado.
Não
string
api-version
consulta
A versão das APIs REST.
Sim
string
Respostas
Modelos
ErrorDetail
O objeto de erro.
Nome
Tipo
Descrição
Obrigatório
código
string
Um de um conjunto de códigos de erro definidos pelo servidor.
Não
message
string
Uma representação legível do erro.
Não
destino
string
O destino do erro.
Não
detalhes
[ Detalhe do erro ]Uma série de detalhes sobre erros específicos que levaram a esse erro relatado.
Não
inner
Erro interno Não
InnerError
Nome
Tipo
Descrição
Obrigatório
código
string
Um código de erro mais específico do que o fornecido pelo erro que o contém.
Não
inner
Erro interno Não
PayloadMessage
Nome
Tipo
Descrição
Obrigatório
destino
string
Sim
argumentos
[ ]
Não
ServiceResponse
Nome
Tipo
Descrição
Obrigatório
código
cadeia de caracteres
Não
Nível
string
Enum: "Info", "Warning", "Error"Não
scope
string
Enum: "Unknown", "Request", "Connection", "User", "Group"Não
tipo de erro
string
Enum: "Unknown", "NotExisted", "NotInGroup", "Invalid"Não
message
string
Não
Objeto json
Não
isSuccess
boolean
Não