Detalles de HTTP
Sugerir cambios
PDF
La API REST de Astra Control utiliza HTTP y los parámetros relacionados para actuar en las instancias y colecciones de recursos. A continuación se presentan los detalles de la implementación HTTP.
Transacciones API y modelo CRUD
La API REST de Astra Control implementa un modelo transaccional con operaciones bien definidas y transiciones de estado.
Cada llamada de API REST se realiza como una solicitud HTTP al servicio Astra. Cada solicitud genera una respuesta asociada al cliente. Este par de solicitud-respuesta puede considerarse una transacción API.
Se accede a cada una de las instancias y colecciones de recursos disponibles a través de la API REST de Astra Control basándose en el modelo CRUD. Hay cuatro operaciones, cada una de las cuales se asigna a un único método HTTP. Entre las operaciones se incluyen:
-
Cree
-
Lea
-
Actualizar
-
Eliminar
Para algunos de los recursos de Astra, sólo se admite un subconjunto de estas operaciones. Debe revisar el "Referencia de API en línea" Para obtener más información acerca de una llamada API específica.
Métodos HTTP
Los métodos o verbos HTTP soportados por la API se presentan en la tabla siguiente.
| Método | CRUD | Descripción |
|---|---|---|
OBTENGA |
Lea |
Recupera propiedades de objeto para una instancia o colección de recursos. Esto se considera una operación de lista cuando se utiliza con una colección. |
PUBLICAR |
Cree |
Crea una nueva instancia de recurso basada en los parámetros de entrada. La URL a largo plazo se devuelve en un |
PUESTO |
Actualizar |
Actualiza una instancia de recurso completa con el cuerpo de solicitud JSON proporcionado. Se conservan los valores clave que no pueden modificarse el usuario. |
ELIMINAR |
Eliminar |
Elimina una instancia de recurso existente. |
Encabezados de solicitud y respuesta
En la siguiente tabla se resumen los encabezados HTTP utilizados con la API REST de Astra Control.
|
Consulte "RFC 7232" y.. "RFC 7233" si quiere más información. |
| Encabezado | Tipo | Notas de uso |
|---|---|---|
Acepte |
Solicitud |
Si el valor es "/" o no se proporciona, |
Autorización |
Solicitud |
Token del portador con la clave API para el usuario. |
Tipo de contenido |
Respuesta |
Devuelto en función del |
ETag |
Respuesta |
Se incluye con un éxito según se define con RFC 7232. El valor es una representación hexadecimal del valor MD5 para todo el recurso JSON. |
Coincidencia IF |
Solicitud |
Cabecera de solicitud de condición previa implementada como se describe en la sección 3.1 RFC 7232 y soporte para solicitudes PUT. |
If-Modified-Since |
Solicitud |
Cabecera de solicitud de condición previa implementada como se describe en la sección 3.4 RFC 7232 y soporte para solicitudes PUT. |
If-Unmodified-since |
Solicitud |
Cabecera de solicitud de condición previa implementada como se describe en la sección 3.4 RFC 7232 y soporte para solicitudes PUT. |
Ubicación |
Respuesta |
Contiene la dirección URL completa del recurso recién creado. |
Parámetros de consulta
Los siguientes parámetros de consulta están disponibles para su uso con colecciones de recursos. Consulte "Trabajar con colecciones" si quiere más información.
| Parámetro de consulta | Descripción |
|---|---|
incluya |
Contiene los campos que se deben devolver al leer una colección. |
filtro |
Indica los campos que deben coincidir para que se devuelva un recurso al leer una colección. |
OrderBy |
Determina el orden de los recursos devueltos al leer una colección. |
límite |
Limita el número máximo de recursos devueltos al leer una colección. |
omitir |
Establece el número de recursos que se van a transferir y omitir al leer una colección. |
cuente |
Indica si se debe devolver el número total de recursos en el objeto de metadatos. |
códigos de estado HTTP
A continuación se describen los códigos de estado HTTP utilizados por la API DE REST de Astra Control.
|
|
La API REST de Astra Control también utiliza el estándar Detalles del problema para API de HTTP. Consulte "Diagnóstico y soporte" si quiere más información. |
| Codificación | Significado | Descripción |
|---|---|---|
200 |
DE ACUERDO |
Indica que las llamadas que no crean una nueva instancia de recurso tienen éxito. |
201 |
Creado |
Se ha creado correctamente un objeto y el encabezado de respuesta de ubicación incluye el identificador único del objeto. |
204 |
Sin contenido |
La solicitud se ha realizado correctamente aunque no se ha devuelto ningún contenido. |
400 |
Solicitud incorrecta |
La entrada de la solicitud no se reconoce o no es apropiada. |
401 |
No autorizado |
El usuario no está autorizado y debe authentir. |
403 |
Prohibido |
Se deniega el acceso debido a un error de autorización. |
404 |
No encontrado |
El recurso al que se hace referencia en la solicitud no existe. |
409 |
Conflicto |
Error al intentar crear un objeto porque el objeto ya existe. |
500 |
Error interno |
Se ha producido un error interno general en el servidor. |
503 |
Servicio no disponible |
El servicio no está listo para atender la solicitud por algún motivo. |