Izmantotā SERP versija ir 8.5 2019-06-05 build 85310221, testēts, izmantojot Postman.
...
Postman sadaļā Authorization izvēlēties opciju Basic Auth un ievadīt tās Personas datus, kura ir Personu grupā ar Rest API tiesībām (2. punkts):
Otro reizi pieķeroties Rest API testēšanai, noskaidroju, ka ar cURL labāk sanāk. Postmanis kaut ko slepus vēl dara ar charsetiem, tādēļ sākotnēji nesanāca POSTot un PATCHot latviešu diakritiskās zīmes.
CURL īsumā
curl -X GET "http://AB:Sample99@localhost:8085/api/1/IVVc" -d "sort=SerNr&range=3900001" atgriezīs rēķinu ar numuru 3900001
Aiz -X nosaka pieprasījuma metodi, aiz -d vai data seko papildus parametri, iekšā vērtībās var būt atstarpes, katru parametru atdala ar &. Postmanī ekvivalents bija Body. Zemāk izklāstītā informācija arī ir valīda, ja izmanto curl.
Lietošana
Laikā, kad top raksts, Hansa apgalvo, ka atbalsta GET, POST un PATCH REST API komandas.
...
Vietas taupīšanas nolūkā dati ir izņemti.
...
.
...
Pieprasījumiem iespējams norādīt papildus parametrus:
...
GET metode strādā arī uz custom laukiem.
| Info |
|---|
Pēdējā testēšanā custom reģistri vispār nestrādā ja ar rest api. Info sekos |
| Info |
|---|
Lai dabūtu ierakstu pēc SerNr vai jebkāda cita reģistra MainKey lauka, jāizmanto range, vienīgi šajā gadījumā pie sort jānorāda lauka nosaukums: sort=SerNr&range=23001 |
| Info |
|---|
Burti ar diakritiskajām zīmēm REST API atbildēs tiek pārversti, piem., ļ → ļ pēdiņas (") → " |
sort
...
Nosaka secību, pēc kura indeksa kārtot. MainKey indekss ir lauka nosaukums.
...
| Note |
|---|
Datu rakstīšana nestrādā uz blokveida un custom reģistriem. Mēģinājums rediģēt custom reģistru crasho DB. |
POST
Ar POST metodi var izveidot jaunus ierakstus.
Piem., http://localhost:8085/api/1/IVVc?set_field.SerNr=99999&set_field.CustCode=10101&set_row_field.0.ArtCode=10&set_row_field.0.Quant=7 - klientam 10101 izveidos rēķinu Nr. 99999 ar 7 artikuliem Nr.10 pirmajā rindā.
PATCH
| Note |
|---|
PATCH pagaidām nestrādā |
Ar PATCH metodi rediģē esošu ierakstu. Esošajam ierakstam piekļūst jau izsaukuma URL norādot MainKey lauka vērtību.
...
<data register="ORVc" sequence="16197" sort="SerNr" key="SerNr" systemversion="8.5.31.221">
TODOs:
- kā POST un PATCH tiekt galā ar diakritiskajām zīmēm (NETIEK) vai arī saprast, kādu charsetu Hansa izmanto, vai arī saprast, kā pareizi pieprasījumā norādīt to
- kā PATCH tiek galā ar custom un blokveida reģistriem (NETIEK)
- English, do you speak it?