Criar Cliente

Criar Cliente #

Cria um novo locatário Cliente

POST /v1.0/clientes

Exemplo #

Este pedido criará um novo Cliente com os seguintes detalhes:

  • Nome: "Novo cliente"
  • Descrição: "Este é o meu novo cliente"
  • Referência: "ABC00001"
  • Ativado: false
  • Fuso Horário: "America/Los_Angeles",
  • Código do país: "US"
  • PbxConnectionProfile
    • Crossbar Api Rest: "https://hostrest"
    • Blackhole Api Websocket: "wss//:hostwebsocket"
    • ~.pbx.kazoo.name.~ AccountId: "accountid"
    • ~.pbx.kazoo.name.~ Api Key: "apikey"
    • monitorSubAccounts: Falso
  • sendNewUserEmail: Falso
  • sendConnectWelcomeEmail: Falso
  • TrialDuration: "0"

Solicitar # 

POST <https://api.na.myreports.cloud/api/v1.0/customers> HTTP/1.1
Tipo de conteúdo: application/json
Aceitação-Encargos: Verdadeiro
Autorização: Portador {TOKEN}
Conexão: keep-alive
{
	"nome": "Novo cliente",
	"descrição": "Este é o meu novo cliente",
	"referência" : "ABC00001",
	"habilitado": false,
	"fuso horário": "America/Los_Angeles",
	"countryCode": "EUA",
	"pbxConnectionProfile": {
		"\_type": "KazooPbxConnectionProfile",
		"hostRest": "http\://hostrest",
		"hostWebsocket": "wss//:hostwebsokcet",
		"accountId": "accountid",
		"apiKey": "apikey",
		"monitorSubAccounts": falso
	},
	"sendNewUserEmail": falso,
	"sendConnectWelcomeEmail": falso,
	"duração do ensaio" : "0"
}

Resposta # 

HTTP/1.1 201 Criado
Tipo de conteúdo: application/json; charset=utf-8
Conteúdo-Comprimento: xx
Localização: <https://api.na.myreports.cloud/api/v1.0/customers/{NEW_CUSTOMER_TENANT_ID}>
{
	"dados": {
		"id": "{NEW_CUSTOMER_TENANT_ID}",
		"nome": "Novo cliente",
		"descrição": "Este é o meu novo cliente",
		"habilitado": false,
		"parentTenantId": "{PARENT_ACCOUNT_TENANT_ID}"
	},
	"status": "sucesso",
	"carimbo de data/hora": "2019-01-01T10:00:00.6829447Z"
}

Erros #

Não autorizado #

Quando o token não é fornecido, inválido ou expirado 

HTTP/1.1 401 Não autorizado

Mau pedido (1) #

Ao solicitar uma avaliação e sua conta de revendedor não tem permissão. 

HTTP/1.1 400 Solicitação incorreta
Data: Thu, 06 Feb 2020 12:45:27 GMT
Tipo de conteúdo: application/json; charset=utf-8
Comprimento do conteúdo: 149
{
	"erro": 400,
	"message": "Os clientes da versão experimental não estão ativados para a sua conta.",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T12:45:27.5903465Z"
}

Mau pedido (2) #

Ao solicitar uma avaliação além da duração máxima da avaliação configurada. 

HTTP/1.1 400 Solicitação incorreta
Data: Thu, 06 Feb 2020 12:45:27 GMT
Tipo de conteúdo: application/json; charset=utf-8
Comprimento do conteúdo: 149
{
	"erro": 400,
	"message": "A avaliação dos clientes excede a duração máxima permitida para a sua conta.",
	"status": "erro",
	"carimbo de data/hora": "2020-02-06T12:45:27.5903465Z"
}