Visión general

Visión general #

El API Se puede utilizar para administrar las propiedades de su cuenta. La siguiente información describe el formato utilizado para API Solicitudes y respuestas.

Ubicaciones de recursos & Base URL #

Dependiendo de la región, su ~.Dimensions.~ se encuentra en, hay diferentes URL para acceder a los recursos de la API. Utilice la siguiente tabla para encontrar la base correcta URL para su región.

Región Base URL
Australia / Nueva Zelanda https://api.au.myreports.cloud
Europa https://api.eu.myreports.cloud
América del Norte https://api.na.myreports.cloud
Reino Unido https://api.uk.myreports.cloud

Una vez que haya identificado la base URL para su región, el formato para cualquier API solicitudes se muestra a continuación:

{BASE_URL}/api/{VERSIÓN}/{RECURSO}

p ej.

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

API Interacción #

El API requiere el uso de JSON definiciones de formato para el contenido de cualquier solicitud. Las respuestas se devolverán en JSON formatear utilizando la siguiente plantilla:

{
	"datos": {
		<returned data>
	},
	"error": <errorCode>,
	"mensaje": <message>,
	"Estado": <status>,
	"Marca de tiempo": <timestamp UTC>
}
Hand Left warning
Es posible que algunos campos no siempre se devuelvan

Si el datos returned es una colección, devolverá una matriz con el tamaño de página.

{
	"page_size": "<number of items>",
	"Datos": [ {
			"ID": "90CE2CCE-5B90-424B-B502-55924F140A48",
		}, {
			"ID": "EC52F7B1-1B74-498E-A49B-59B71022C3A1",
		}
	][{
			"id": "90ce2cce-5b90-424b-b502-55924f140a48",
		}, {
			"id": "ec52f7b1-1b74-498e-a49b-59b71022c3a1",
		}
	],
	"status": "éxito",
	"marca de tiempo": "<timestamp in UTC>"
}

API Recursos #

En la tabla siguiente se proporciona un resumen de los recursos que API Proporciona acceso a:

Recurso Descripción
Directorios Consulte directorios y administre elementos de directorio individuales.

Cada recurso proporciona las siguientes interfaces para la interacción:

Interfaz Descripción
Obtener todo Devuelve una colección de todos los elementos que coinciden con el tipo de recurso.
Obtener... Devuelve una instancia específica del tipo de recurso.
Crear... Crea una nueva instancia de un tipo de recurso.
Parche... Actualiza una instancia existente del tipo de recurso.
Borrar... Quita una instancia existente de un tipo de recurso.