Sobre petições REST
As estrutyuras abaixo são compatíveis com petições REST:
| URI | Recurso | /? /? or &{filter} (Output) |
|---|---|---|
| http://{servername}:{port}/rest/ | {dataClass} | $filter, $attributes, $skip, $method=...... |
| {dataClass}/$entityset/{entitySetID} | $method=... | |
| {dataClass}({key}) | $attributes | |
| {dataClass}:{attribute}(value) |
Todas as petições REST devem conter os parâmetros URI e Resource, mas o parâmetro Subresource (que filtra os dados retornados) é opcional.
Como com todas as URIs, o primeiro parâmetro é definido por um “?” e todos os parâmetros subsequentes por “&”. Por exemplo:
GET /rest/Person/?$filter="lastName!=Jones"&$method=entityset&$timeout=600
Pode colocar todos os valores entre aspas para evitar ambiguidades. Por exemplo, no exemplo anterior, poderíamos colocar o valor para o último nome em aspas simples: "lastName!='Jones'".
Os parâmetros permitem que manipule dados em dataclasses em seu projeto 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.
If you want the data to be returned in an array instead of JSON, use the $asArray parameter.
Estado e resposta REST
Com cada petição REST, o servidor retorna o estado e uma resposta (com ou sem um erro).
Estado da petição
Com cada petição REST, se obtém o estado junto com a resposta. Abaixo estão alguns estados que podem surgir:
| Estado | Descrição |
|---|---|
| 0 | Petição não processada (servidor pode não ter iniciado). |
| 200 OK | Petição processada sem erro. |
| 401 Unauthorized | Erro de autorização (verifique as permissões do usuário). |
| 402 No session | Número máximo de sessões foi alcançado. |
| 404 Not Found | A classe de dados não é acessível via REST ou o conjunto de entidades não existe. |
| 500 Internal Server Error | Erro processando a petição REST. |
Resposta
A resposta (em formato JSON) varia dependendo da petição.
Se um erro surgir, será enviado junto com a resposta do servidor ou será a resposta do servidor.