Visão geral #

O API pode ser usado para provisionar clientes e gerenciar usuários e PBX conexões. As informações abaixo descrevem o formato usado para API pedidos e respostas.

Locais de recursos & Base URL #

Dependendo da região, o seu ~.Dimensions.~ instância está localizada em, há diferentes URLs para acessar os recursos da api. Por favor, use a tabela abaixo para encontrar a base correta URL para a sua região.

Depois de ter identificado a base URL para a sua região, o formato para qualquer API Os pedidos são mostrados abaixo:

{BASE_URL}/api/{VERSÃO}/{RECURSO}

por exemplo,

https://api.na.myreports.cloud/api/v1.0/customers

API Interação #

O API requer o uso de definições de formato Json para o conteúdo de quaisquer solicitações. Todas as respostas serão retornadas no formato Json usando o seguinte modelo:

{
	"dados": {
		<returned data>
	},
	"erro": <errorCode>,
	"mensagem": <message>,
	"Estado": <status>,
	"carimbo de data/hora": <timestamp UTC>
}

warning
Alguns campos podem nem sempre ser devolvidos

Se o dados retornado é uma coleção, ele retornará uma matriz com o tamanho da página.

{
	"page_size": "<number of items>",
	"dados": [ {
			"Identificação": "90ce2cce-5b90-424b-b502-55924f140a48",
		}, {
			"ID": "EC52F7B1-1B74-498E-A49B-59B71022C3A1",
		}
	][{
			"id": "90ce2cce-5b90-424b-b502-55924f140a48",
		}, {
			"id": "ec52f7b1-1b74-498e-a49b-59b71022c3a1",
		}
	],
	"status": "sucesso",
	"carimbo de data/hora": "<timestamp in UTC>"
}

API Recursos #

A tabela a seguir fornece um esboço dos recursos que o API dá acesso a:

Cada recurso fornece as seguintes interfaces para interação: