Saltar al contenido principal
Versión: v20 R4 BETA

Acerca de las peticiones REST

Se soportan las siguientes estructuras para las peticiones REST:

URIResource (Input)/? /? or &{filter} (Output)
http://{servername}:{port}/rest/{dataClass}$filter, $attributes, $skip, $method=......
{dataClass}/$entityset/{entitySetID}$method=...
{dataClass}({key})$attributes
{dataClass}:{attribute}(value)

Mientras que todas las solicitudes REST deben contener los parámetros URI y Resource, los filtros de salida (que filtran los datos devueltos) son opcionales.

Como en todos los URI, el primer parámetro está delimitado por un "?" y todos los siguientes por un "&". Por ejemplo:

GET /rest/Person/?$filter="lastName!=Jones"&$method=entityset&$timeout=600

Puede colocar todos los valores entre comillas en caso de ambigüedad. Por ejemplo, en nuestro ejemplo anterior, podríamos haber puesto el valor del apellido entre comillas simples: "lastName!='Jones'".

Los parámetros le permiten manipular los datos de las clases de datos en su proyecto 4D. Además de recuperar datos mediante los métodos HTTP GET, también se pueden añadir, actualizar y eliminar entidades de una clase de datos utilizando los métodos HTTP POST.

Si desea que los datos se devuelvan en un array en lugar de en JSON, utilice el parámetro $asArray.

Estado y respuesta REST

Con cada petición REST, el servidor devuelve el estado y una respuesta (con o sin error).

Estado de la petición

Con cada solicitud REST, se obtiene el estado junto con la respuesta. A continuación se presentan algunos de los estados que pueden surgir:

EstadoDescripción
0Solicitud no procesada (el servidor podría no estar iniciado).
200 OKPetición procesada sin error.
401 UnauthorizedError de permisos (compruebe los permisos del usuario).
402 No sessionSe ha alcanzado el número máximo de sesiones.
404 Not FoundLa clase de datos no es accesible vía REST o el conjunto de entidades no existe.
500 Internal Server ErrorError al procesar la solicitud REST.

Respuesta

La respuesta (en formato JSON) varía en función de la petición.

Si se produce un error, se enviará junto con la respuesta del servidor o será la respuesta del servidor.