Sākumlapa/Api: Atšķirības starp versijām

No ''Ramus Wiki''
Pāriet uz navigāciju Pāriet uz meklēšanu
2. rindiņa: 2. rindiņa:


== Session ==
== Session ==
Curl


Šajā sadaļā ir aprakstīti soļi sesijas uzsākšanai un konfigurēšanai Ramus Accountant API.
=== 1. Lietotāja autorizācija (Login) ===
Pieprasījums, lai iegūtu sesijas ID un API atslēgu.
'''Curl:'''
<syntaxhighlight lang="bash">
curl -X 'POST' \
curl -X 'POST' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user' \
12. rindiņa: 18. rindiņa:
   "password": "?????????"
   "password": "?????????"
}'
}'
</syntaxhighlight>


Request URL
'''Request URL:'''
"https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user"
<code>https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user</code>
Response body
 
'''Response body:'''
<syntaxhighlight lang="json">
{
{
   "error": false,
   "error": false,
   "message": "Logged In",
   "message": "Logged In",
23. rindiņa: 31. rindiņa:
   "apiKey": "Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV"
   "apiKey": "Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV"
}
}
</syntaxhighlight>
---


Curl
=== 2. Darba vides (Workspace) atrašana ===
Iegūst pieejamo darba vidi sarakstu izmantojot saņemto sesiju.


'''Curl:'''
<syntaxhighlight lang="bash">
curl -X 'GET' \
curl -X 'GET' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find' \
   -H 'accept: application/json' \
   -H 'accept: application/json' \
   -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B",   "workspaceName": "PARAUGS" }' \
   -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "workspaceName": "PARAUGS" }' \
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'
   
</syntaxhighlight>
Request URL
 
"https://demo.ramusnet.eu/ramusAccountant/service/api/session/find"
'''Request URL:'''
Response body
<code>https://demo.ramusnet.eu/ramusAccountant/service/api/session/find</code>
 
'''Response body:'''
<syntaxhighlight lang="json">
{
{
   "workspaces": [
   "workspaces": [
50. rindiņa: 67. rindiņa:
           }
           }
         ]
         ]
      }
    },
    {
      "serverDataSourceId": 1002,
      "name": "edani.ramusnet.lv",
      "data": {
        "total": 0,
        "rows": []
      }
    },
    {
      "serverDataSourceId": 1003,
      "name": "saldos.ramusnet.lv",
      "data": {
        "total": 0,
        "rows": []
       }
       }
     }
     }
   ]
   ]
}
}
</syntaxhighlight>


Curl
---


=== 3. Finanšu periodu atrašana ===
Iegūst sarakstu ar pieejamajiem gadiem/periodiem konkrētajā darba vidē.
'''Curl:'''
<syntaxhighlight lang="bash">
curl -X 'GET' \
curl -X 'GET' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find/periods' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find/periods' \
   -H 'accept: application/json' \
   -H 'accept: application/json' \
   -H 'query: {   "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B",   "serverDataSourceId": "1001",   "workspaceId": "150734769495" }' \
   -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "serverDataSourceId": "1001", "workspaceId": "150734769495" }' \
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'
</syntaxhighlight>


Request URL 
'''Response body (saīsināts):'''
"https://demo.ramusnet.eu/ramusAccountant/service/api/session/find/periods"
<syntaxhighlight lang="json">
Response body
{
{
   "financialPeriod": [
   "financialPeriod": [
     {
     {
       "serverDataSourceId": 1001,
       "serverDataSourceId": 1001,
      "name": "demo.ramusnet.lv",
       "code": "DEMO",
       "code": "DEMO",
       "data": [
       "data": [
93. rindiņa: 99. rindiņa:
           "code": "2024",
           "code": "2024",
           "from": "01.01.2024",
           "from": "01.01.2024",
           "till": "31.12.2024",
           "till": "31.12.2024"
          "workspaceId": 150734769495
        },
        {
          "financialPeriodId": 666818956382,
          "code": "2023",
          "from": "01.01.2023",
          "till": "31.12.2023",
          "workspaceId": 150734769495
        },
        {
          "financialPeriodId": 641738108062,
          "code": "2022",
          "from": "01.01.2022",
          "till": "31.12.2022",
          "workspaceId": 150734769495
        },
        {
          "financialPeriodId": 612698191483,
          "code": "2021",
          "from": "01.01.2021",
          "till": "31.12.2021",
          "workspaceId": 150734769495
         }
         }
       ]
       ]
121. rindiņa: 105. rindiņa:
   ]
   ]
}
}
</syntaxhighlight>


Curl
---


=== 4. Sesijas saglabāšana (Store) ===
Iestata aktīvo darba vidi un finanšu periodu tekošajai sesijai.
'''Curl:'''
<syntaxhighlight lang="bash">
curl -X 'POST' \
curl -X 'POST' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/store' \
   'https://demo.ramusnet.eu/ramusAccountant/service/api/session/store' \
   -H 'accept: application/json' \
   -H 'accept: application/json' \
   -H 'query: {   "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B",   "serverDataSourceId": "1001",   "workspaceId": "150734769495",   "financialPeriodId": "641738108062" }' \
   -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "serverDataSourceId": "1001", "workspaceId": "150734769495", "financialPeriodId": "641738108062" }' \
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV' \
   -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV' \
   -d ''
   -d ''
 
</syntaxhighlight>
Request URL
 
|https://demo.ramusnet.eu/ramusAccountant/service/api/session/store"
'''Response body:'''
Response body
<syntaxhighlight lang="json">
{
{
   "success": true,
   "success": true,
143. rindiņa: 133. rindiņa:
   }
   }
}
}
</syntaxhighlight>


== Stock ==
== Stock ==

Versija, kas saglabāta 2026. gada 11. marts, plkst. 09.08

Session

Šajā sadaļā ir aprakstīti soļi sesijas uzsākšanai un konfigurēšanai Ramus Accountant API.

1. Lietotāja autorizācija (Login)

Pieprasījums, lai iegūtu sesijas ID un API atslēgu.

Curl: <syntaxhighlight lang="bash"> curl -X 'POST' \

 'https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user' \
 -H 'accept: */*' \
 -H 'Content-Type: application/json' \
 -d '{
 "usernameOrEmail": "vards.uzvards@pasts.lv",
 "password": "?????????"

}' </syntaxhighlight>

Request URL: https://demo.ramusnet.eu/ramusAccountant/service/api/session/login/user

Response body: <syntaxhighlight lang="json"> {

 "error": false,
 "message": "Logged In",
 "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B",
 "apiKey": "Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV"

} </syntaxhighlight>

---

2. Darba vides (Workspace) atrašana

Iegūst pieejamo darba vidi sarakstu izmantojot saņemto sesiju.

Curl: <syntaxhighlight lang="bash"> curl -X 'GET' \

 'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find' \
 -H 'accept: application/json' \
 -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "workspaceName": "PARAUGS" }' \
 -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'

</syntaxhighlight>

Request URL: https://demo.ramusnet.eu/ramusAccountant/service/api/session/find

Response body: <syntaxhighlight lang="json"> {

 "workspaces": [
   {
     "serverDataSourceId": 1001,
     "name": "demo.ramusnet.lv",
     "data": {
       "total": 1,
       "rows": [
         {
           "userId": 144332002024,
           "workspace": "PARAUGS",
           "workspaceId": 150734769495,
           "registrationNr": "40103659822"
         }
       ]
     }
   }
 ]

} </syntaxhighlight>

---

3. Finanšu periodu atrašana

Iegūst sarakstu ar pieejamajiem gadiem/periodiem konkrētajā darba vidē.

Curl: <syntaxhighlight lang="bash"> curl -X 'GET' \

 'https://demo.ramusnet.eu/ramusAccountant/service/api/session/find/periods' \
 -H 'accept: application/json' \
 -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "serverDataSourceId": "1001", "workspaceId": "150734769495" }' \
 -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV'

</syntaxhighlight>

Response body (saīsināts): <syntaxhighlight lang="json"> {

 "financialPeriod": [
   {
     "serverDataSourceId": 1001,
     "code": "DEMO",
     "data": [
       {
         "financialPeriodId": 710951063977,
         "code": "2024",
         "from": "01.01.2024",
         "till": "31.12.2024"
       }
     ]
   }
 ]

} </syntaxhighlight>

---

4. Sesijas saglabāšana (Store)

Iestata aktīvo darba vidi un finanšu periodu tekošajai sesijai.

Curl: <syntaxhighlight lang="bash"> curl -X 'POST' \

 'https://demo.ramusnet.eu/ramusAccountant/service/api/session/store' \
 -H 'accept: application/json' \
 -H 'query: { "sessionId": "D821FE10B0C80B72D8A471E6C19BD18B", "serverDataSourceId": "1001", "workspaceId": "150734769495", "financialPeriodId": "641738108062" }' \
 -H 'Authorization: Ramus eyJhbGciOiJIUzM4NCJ9.eyJzdWIiOiJqdXJpcy5wb2RzQGdtYWlsLmNvbSIsImlhdCI6MTcyMzY0MTAzNCwiZXhwIjoxNzIzNjg0MjMzfQ.Dosm3U8y-d73JE9EUHA3eAJOZutsaA1hkG48S2jMc1rR-00xGscz_iCuumIl7BlV' \
 -d 

</syntaxhighlight>

Response body: <syntaxhighlight lang="json"> {

 "success": true,
 "subject": {
   "userId": "144332002024",
   "workspaceId": "150734769495",
   "financialPeriodId": "641738108062",
   "sesionId": "D821FE10B0C80B72D8A471E6C19BD18B"
 }

} </syntaxhighlight>

Stock

Tax

Authenticate

Document

Comment

Imports

Link

Person

Product

Report

Custom

Standard