Pular para o conteúdo principal

kobana dunning notification-preferences

Comandos de kobana dunning notification-preferences. Toda opção global (Opções globais) vale aqui.

ComandoHTTPDescrição
notification-preferences listGET /v1/notification-preferencesConsultar preferências de notificação
notification-preferences updatePUT /v1/notification-preferencesAtualizar preferências de notificação

notification-preferences list​

Consultar preferências de notificação

kobana dunning notification-preferences list [OPÇÕES]

GET /v1/notification-preferences

Retorna o gate efetivo por tipo de mensagem — tipos sem registro salvo aparecem com todos os canais ligados.

Cabeçalhos

NomeTipoObrigatórioDescrição
X-Workspace-IdstringnãoWorkspace em que a chamada age (id ou public_id, listados em GET /v1/workspaces). Opcional enquanto a organização tem um só workspace; com dois ou mais, sem ele a resposta é 400 WORKSPACE_REQUIRED. Um workspace de outra organização é 403 UNKNOWN_WORKSPACE.

Respostas

HTTPDescrição
200Preferências efetivas por tipo.
404Recurso inexistente ou fora da sua organização.
413Corpo da requisição acima de 2 MB.

notification-preferences update​

Atualizar preferências de notificação

kobana dunning notification-preferences update [OPÇÕES]

PUT /v1/notification-preferences

Faz upsert das preferências enviadas (parcial: só os tipos incluídos são alterados).

Cabeçalhos

NomeTipoObrigatórioDescrição
X-Workspace-IdstringnãoWorkspace em que a chamada age (id ou public_id, listados em GET /v1/workspaces). Opcional enquanto a organização tem um só workspace; com dois ou mais, sem ele a resposta é 400 WORKSPACE_REQUIRED. Um workspace de outra organização é 403 UNKNOWN_WORKSPACE.

Corpo da requisição

NomeTipoObrigatórioDescrição
preferencesarray<object>sim

Outros campos e objetos aninhados: kobana schema dunning.notification-preferences.update.

Respostas

HTTPDescrição
200Preferências gravadas.
400Requisição inválida (erro de validação).
404Recurso inexistente ou fora da sua organização.
413Corpo da requisição acima de 2 MB.