Izmantotā SERP versija ir 8.5 2019-06-05 build 85310221, testēts, izmantojot Postman.
...
Code Block |
---|
<?xml version='1.0' encoding='UTF-8' standalone='yes'?> <data register="IVVc" sequence="16784" systemversion="8.5.28.1014"> <IVVc> <SerNr>23001</SerNr> <InvDate>2003-10-20</InvDate> <CustCode>10101</CustCode> <Math></Math> <PayDate>2003-10-30</PayDate> <Addr0>Dūrējs SIA</Addr0> <Addr1>Daugavgrīvas iela 5</Addr1> <Addr2>Rīga, LV-1022</Addr2> <Addr3>LATVIJA</Addr3> <OurContact></OurContact> <ClientContact>Jānis Cirpējs</ClientContact> <ExportFlag>0</ExportFlag> <PayDeal>10</PayDeal> <OrderNr>23003</OrderNr> <Prntdf>1</Prntdf> <OKFlag>1</OKFlag> [..] <rows> <row rownumber="0"> <stp>1</stp> <ArtCode>1065941I</ArtCode> <Quant>2</Quant> <Price>17.53</Price> <Sum>35.06</Sum> <vRebate></vRebate> <SalesAcc>6110</SalesAcc> <Objects>10</Objects> [..] </row> [..] </rows> </IVVc> [..] </data> |
<?xml version='1.0' encoding='UTF-8' standalone='yes'?>
<data register="IVVc" sequence="16784" systemversion="8.5.28.1014">
<IVVc>
<SerNr>23001</SerNr>
<InvDate>2003-10-20</InvDate>
<CustCode>10101</CustCode>
<Math></Math>
<PayDate>2003-10-30</PayDate>
<Addr0>Dūrējs SIA</Addr0>
<Addr1>Daugavgrīvas iela 5</Addr1>
<Addr2>Rīga, LV-1022</Addr2>
<Addr3>LATVIJA</Addr3>
<OurContact></OurContact>
<ClientContact>Jānis Cirpējs</ClientContact>
<ExportFlag>0</ExportFlag>
<PayDeal>10</PayDeal>
<OrderNr>23003</OrderNr>
<Prntdf>1</Prntdf>
<OKFlag>1</OKFlag>
[..]
<rows>
<row rownumber="0">
<stp>1</stp>
<ArtCode>1065941I</ArtCode>
<Quant>2</Quant>
<Price>17.53</Price>
<Sum>35.06</Sum>
<vRebate></vRebate>
<SalesAcc>6110</SalesAcc>
<Objects>10</Objects>
[..]
</row>
[..]
</rows>
</IVVc>
[..]
</data>
Piemērā, tika izmantots vienkāršs GET pieprasījums - http://localhost:8085/api/1/IVVc , kas atgrieza visus rēķinus.
...
Piem., http://localhost:8085/api/1/IVVc?sort=CustCode&fields=SerNr,CustCode,Addr0,
Datu iegūšana
GET
Atbildes uz visiem pieprasījumiem varam formatēt, izmantojot GET papildu parametrus:
...
Note |
---|
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 |
Datu rakstīšana
Datus rakstīšanai pastāv 2 parametri:
- set_field._______ - norāda lauka vērtību, aiz punkta norāda lauka nosaukumu;
- set_row_field.#._______ - norāda rindas lauka vērtību, aiz punkta norāda rindas numuru (sāk skaitīt no 0), tālāk lauka nosaukumu.
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
...
Ar PATCH metodi rediģē esošu ierakstu. Esošajam ierakstam piekļūst jau izsaukuma URL norādot MainKey lauka vērtību.
Piem., http://localhost:8085/api/1/IVVc/99999?set_field.CustCode=20202&set_row_field.0.Quant=9 - ierakstam Nr. 99999 nomainīs klientu uz 20202 un pirmās rindas skaitu uz 9.
JTE TODOs:
- updates_after and deletes_after
- POST komandas
- kā POST un PATCH spēj tikt 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
- PATCH komandas - interesanti būtu paskatīties, ko API dara ar ierakstiem, kuros jau ir diakritiskās zīmes
- kā PATCH tiek galā ar custom un blokveida reģistriem
- saprast, kā šo var darīt bez Postman