Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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&#363;r&#275;js SIA</Addr0>
<Addr1>Daugavgr&#299;vas iela 5</Addr1>
<Addr2>R&#299;ga, LV-1022</Addr2>
<Addr3>LATVIJA</Addr3>
<OurContact></OurContact>
<ClientContact>J&#257;nis Cirp&#275;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