Scale Monitor REST API

1. Uvod

Scale Monitor REST API omogućuje jednostavnu integraciju sustava Scale Monitor s vašim sustavima te nudi prilagodljive mogućnosti za razmjenu podataka. Podržava dohvat podataka iz sustava Scale Monitor i izravno primanje podataka o vaganju u vaš sustav.

1.1. Mogućnosti integracije

Vaš sustav poziva Scale Monitor API

• Dohvatite podatke o vaganju u stvarnom vremenu ili povijesne podatke izravno s platforme Scale Monitor. • Pristupite potpuno prilagođenim podacima o vaganju prema svojim operativnim zahtjevima. • Iskoristite mogućnosti obrade i pohrane podataka sustava Scale Monitor za pojednostavnjenje radnih procesa.

Scale Monitor šalje podatke o vaganju vašem REST API-ju

• Konfigurirajte Scale Monitor za slanje podataka o vaganju u stvarnom vremenu izravno vašoj mrežnoj usluzi. • Prilagodite okidače slanja i formate isporuke podataka za jednostavnu integraciju s postojećim sustavima. • Zadržite potpunu kontrolu nad primanjem i obradom podataka unutar svoje infrastrukture.

Vaš sustav sprema vaganja u ScaleMonitor putem REST API-ja

• Omogućuje spremanje vaganja iz vašeg sustava u oblak ScaleMonitor.

1.2. Glavne prednosti

• Prilagodljivost: odaberite način integracije koji najbolje odgovara vašem načinu rada. • Komunikacija u stvarnom vremenu: omogućite trenutačnu razmjenu podataka između sustava Scale Monitor i svojih sustava. • Prilagodba: prilagodite formate podataka, okidače i radne tokove svojim poslovnim procesima. • Kompatibilnost: radi s bilo kojom vagom ili uređajem za vaganje, neovisno o proizvođaču.

1.3. Primjeri primjene• Automatski sinkronizirajte podatke o vaganju sa sustavima ERP, WMS ili LIMS. • Primajte obavijesti i ažuriranja podataka u stvarnom vremenu za precizan nadzor. • Pojednostavnite složene radne tokove automatiziranom razmjenom i sinkronizacijom podataka.

4. API tokeni

ScaleMonitor REST API koristi standardne JWT tokene koji se dostavljaju na zahtjev. Token se mora poslati sa zahtjevom u zaglavlju Authorization vrste Bearer.

5. API metode 5.1. Dohvat vaganja

Krajnja točka

POST /Api/ScaleMonitor/ScaleMonitorApi/getWeighings/

Opis

Dohvaća popis vaganja sustava Scale Monitor prema zadanim filtrima.

Zahtjev

Zaglavlja

Parametri POST (JSON BODY)

{ "dateTimeFrom": "2025-03-01", "dateTimeTo": "2025-03-25", "scaleId": 123 }

Odgovor

Uspješan odgovor (200 OK )

{ "data": { "numberOfWeighings": 1, "weighings": [ { "weighingNumber": 1432, "weighingDateTime": "2025-03-22 11:39:58", "gross": "1600 kg", "net": "0 kg", "tare": "0 kg", "stability": 0, "scaleData": { "title": "Ranger 3000", "inventoryNumber": "D23541", "uuid": "db33e782-45a3-11ef-9aad-f9b59ffd187f", "id": 123 }, "additionalParameters": [ { "parameterName": "Material", "value": "Nail", "uuid": "99703ee3-f8fe-11ef-8d03-00155de9e731" }, { "parameterName": "Material ID", "value": "SN94735", "uuid": "96703ee3-f8fe-11ef-8d03-00155de9e731" } ] } ] }, "error": 0 }

Odgovor s pogreškom (400 Bad Requestili500 Internal Server Error )

{ "error": 1, "errorMessage": "Failed getting weighings: Internal server error" }

Krajnja točka

POST /Api/ScaleMonitor/ScaleMonitorApi/saveWeighing/

Opis

Sprema vaganje u bazu podataka sustava ScaleMonitor.

Zahtjev

Zaglavlja

Parametri POST (JSON BODY)

Primjer zahtjeva

{ "scaleId": "123", "checkForDuplicates":false, "constantForDuplicate":"", "duplicateValueCheck":"", "parameters":[

{"constantName":"lot","value":"20250326001"}, {"constantName":"articleCode","value":"AB2025-16"}, {"constantName":"grossWeight","value":"12.4"}, {"constantName":"netWeight","value":"12.4"}, {"constantName":"tareWeight","value":"0"}, {"constantName":"unit","value":"g"} ] }

Uspješan odgovor (200 OK )

{ "data": { "text": "Weighing saved successfully", "weighingNumber": 253, "duplicateValueCheck": "", "weighingAdded": true }, "error": 0 }

Odgovor s pogreškom (400 Bad Requestili500 Internal Server Error )

{ "error": 1, "errorMessage": "Failed while saving weighing: E:Error while retrieving ScaleMonitor data }

Konstante API-ja postavljaju se u sustavu ScaleMonitor na kartici 'API settings'. U tablicu možete unijeti API konstantu, odnosno naziv konstante koju šaljete API-ju. U stupcu 'parameter' odaberite parametar koji će ta konstanta predstavljati. Parametri mogu biti statični (npr. bruto masa, neto masa...) ili dinamični, poput dodatnih parametara (npr. LOT, Article code) koje sami definirate.

5.3. Uvoz zapisa u bazu podataka putem API-ja Krajnja točka

POST /Api/DynamicEntityList/DynamicEntityListApi/insertDatabaseValue/

Opis

Uvozi retke u željenu bazu podataka.

Zahtjev

Zaglavlja

Parametri POST (JSON BODY)

Objekt JSON čiji je naziv šifra baze podataka. Unutar objekta nalazi se niz redaka baze podataka; svaki redak ima šifru parametra kao naziv, a vrijednost kao sadržaj.

Broj redaka i baza podataka u koje se može istodobno unositi nije ograničen.

Primjer zahtjeva

{ "Products": [ { "ID": "2025001", "Title": "Screw" }, { "ID": "2025002", "Title": "Bolt" } ] }

Odgovor

Uspješan odgovor

{ "msg": "Database values have been inserted successfully!", "error": 0 }

{ "error": 1 "errorMessage": "Error inserting database values: Attribute has not been found!Internal server error" }

6. Kako pronaći ID vage

ID-jevi vaga prikazani su u svakoj aplikaciji ScaleMonitor za pripadajuće vage. Padajući izbornik s ID-jem vage otvara se klikom na gumb za informacije (krug sa slovom „i”).

7. Testiranje API-ja

Za testiranje se preporučuje softver poput ARC (Advanced rest client).

Testiranje se može provesti unosom URL-a, podataka zaglavlja, autorizacije i tijela zahtjeva.

Nakon unosa svih potrebnih podataka možete ih poslati i primiti odgovor u kojem korisnik može provjeriti valjanost odgovora i podataka.