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>
}
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. |