SCALEWEBLINK · v1.5 · REST / JSON

ScaleWebLink – korisnički priručnik i REST API

HTML upute ScaleWebLink v1.5: postavljanje protokola, POST JSON, MID i PIN, podaci o masi, ERR01–ERR10, API test i simulator.

Upute na slovenskom ↗

← Svi priručnici proizvoda

1. Svrha i rad

ScaleWebLink komunicira s vagom putem REST mrežnih usluga šifriranih SSL-om. Vaga se povezuje s oblakom putem modula CloudScaleLink. Vanjski sustav šalje radnju i prima JSON odgovor.

Svaki modul CloudScaleLink ima jedinstveni MID (Module ID) i PIN (Module PIN). Zajedno omogućuju autorizirani pristup vagi. Za virtualni CloudScaleLink MID i PIN dostavljaju se e-poštom.

Potreban vam je račun Scale Monitor, povezana vaga s odgovarajućim protokolom ili simulator te pristup usluzi. Podržane naredbe i dostupna polja ovise o vagi i protokolu.

2. Brzi početak

Registrirajte se putem partnerske poveznice ili register.scale-monitor.com i prijavite se u Scale Monitor.
Dodajte vagu i provjerite njezinu vezu s modulom CloudScaleLink.
Otvorite Menu → Protocol → ScaleWebLink.
Odaberite Protocol i Protocol version.
Dodijelite prikladnu naredbu za očitavanje mase radnji Get_Weight.
Otvorite API test, odaberite radnju i pošaljite je.
Provjerite odgovor, a zatim integrirajte POST zahtjev u svoju aplikaciju.

3. Protokol, radnje i naredbe

U Menu → Protocol → ScaleWebLink odaberite protokol i verziju za povezanu vagu. Izvorni priručnik kao primjer koristi Mettler Toledo MT SICS.

Tablica postavki ima dva stupca: Action naziv je radnje koju poziva vaša aplikacija, a Command naredba koja se šalje vagi.

Zadani naziv radnje Get_Weight ne može se promijeniti, ali može se odabrati dodijeljena naredba. Kliknite Add da biste izradili redak, unesite naziv vlastite radnje i odaberite naredbu.

Polje / kôd	Značenje i upotreba
`Get_Weight → SIX1`	Primjer zahtjeva za masu uz MT SICS, verzija MT SICS_1.
`Tare → T`	Primjer tariranja MT SICS: radnja Tare šalje naredbu T.

Primjeri MT SICS nisu univerzalne naredbe za druge vage. Provjerite dostupne funkcije u protokolu povezanog uređaja.

4. POST zahtjev i autorizacija

Pošaljite objekt JSON s tri polja. Nazivi polja pišu se malim slovima.

Polje / kôd	Značenje i uporaba
`mid`	ID modula CloudScaleLink.
`pin`	PIN modula CloudScaleLink.
`action`	Get_Weight ili naziv spremljene prilagođene radnje.

Za fizički modul MID i PIN nalaze se na njegovoj oznaci. Za virtualni modul koristite pristupne podatke dostavljene e-poštom.

Adresa API-ja: koristite URL usluge dodijeljen vašoj vezi. PDF v1.5 ne navodi konkretan URL krajnje točke; obratite se podršci ako ga nemate. Primjer u nastavku koristi izričito označeni rezervirani naziv, a ne aktivnu krajnju točku.

{
  "mid": "yourMID",
  "pin": "yourCSLPIN",
  "action": "Get_Weight"
}

cURL

# Zamijenite ogledni URL i pristupne podatke modula.
curl --request POST 'https://YOUR-SCALEWEBLINK-ENDPOINT' --header 'Content-Type: application/json' --data '{"mid":"yourMID","pin":"yourCSLPIN","action":"Get_Weight"}'

5. JSON odgovor

ScaleWebLink vraća objekt JSON. Primjer zadržava odgovor iz uputa v1.5; dostupnost i sadržaj podataka ovise o protokolu vage.

Polje / kôd	Značenje i uporaba
`error`	0 = nema pogreške; 1 = došlo je do pogreške.
`errorCode`	Kôd pogreške; pogledajte poglavlje 7.
`errorMsg`	Kratki opis pogreške.
`scaleResponse`	Neobrađeni niz znakova primljen od vage kao odgovor na naredbu.
`dateTime`	UTC datum i vrijeme izvršavanja radnje.
`weightData`	Objekt koji sadrži dostupne podatke o masi.

Upute v1.5 prikazuju dateTime kao tekstualni UTC datum. Izvorna mrežna stranica prikazuje i brojčanu vremensku oznaku te mase kao nizove znakova. Provjerite stvarni odgovor svoje usluge i odabranog protokola te u skladu s time pretvorite vrste podataka; nemojte pretpostavljati jedinstven format.

{
  "error": 0,
  "errorCode": null,
  "errorMsg": "",
  "scaleResponse": "SIX1 S 0 N R R 0 0 0 1 P 0.068     0.000   0.068 kg",
  "dateTime": "Wed, 04 Sep 2024 11:07:51 GMT",
  "weightData": {
    "net": 0,
    "gross": 0.068,
    "tare": 0.068,
    "unit": "kg",
    "stability": 1,
    "expectedResponseStatus": null,
    "expectedResponseMsg": null
  }
}

6. weightData polja

Polje / kôd	Značenje i upotreba
`net`	Neto masa; null ako nije primljena.
`gross`	Bruto masa; null ako nije primljena.
`tare`	Vrijednost tare; null ako nije primljena.
`unit`	Jedinica mase; null ako nije primljena.
`stability`	null = nema podataka; 0 = nestabilna vaga; 1 = stabilna vaga.
`expectedResponseStatus`	null = nije postavljeno; 0 = odgovor nije OK; 1 = odgovor je OK.
`expectedResponseMsg`	Poruka postavljena za odgovarajuću naredbu u postavkama protokola.

null nije masa nula. Prije upotrebe mjerenja provjerite pogreške, potrebna polja, jedinicu i stabilnost. Ogledne vrijednosti nisu referentna mjerenja; provjerite raščlanjivanje sa stvarnom vagom.

7. Kodovi grešaka i rješavanje problema

Ako radnja ne uspije, odgovor sadrži kôd pogreške. Najprije provjerite JSON i konfiguraciju radnje, a zatim povezivost i odgovor vage.

Polje / kôd	Značenje i uporaba
`ERR01`	Nedostaju obvezni POST podaci ili JSON nije valjan. Provjerite tijelo zahtjeva i sintaksu JSON-a.
`ERR02`	Nedostaje ID modula (MID). Uključite mid.
`ERR03`	Nedostaje PIN modula. Uključite pin.
`ERR04`	Nedostaje radnja. Uključite action.
`ERR05`	Radnja nije pronađena među spremljenim radnjama. Provjerite njezin naziv i konfiguraciju.
`ERR06`	Nije pronađen Scale Monitor povezan s primljenom temom. Provjerite temu i vezu.
`ERR07`	Podaci naredbe nisu pronađeni. Odaberite valjanu naredbu za radnju.
`ERR08`	Nedostaje niz znakova naredbe. Provjerite svojstvo naredbe u odabranom protokolu.
`ERR09`	Usluga je zauzeta: drugi klijent komunicira s vagom koristeći isti MID i PIN. Šaljite zahtjeve jedan za drugim i pokušajte ponovno kasnije.
`ERR10`	Istek vremena: odgovor nije primljen unutar zadanog vremena. Provjerite povezanost vage i protokol.

8. API test

Otvorite Protocol → ScaleWebLink.
Kliknite API test pri dnu stranice.
U novom prozoru odaberite spremljenu radnju.
Pošaljite radnju i pregledajte prikaz odgovora.

Primjer iz priručnika: Protocol: MT SICS, Version: MT SICS_1, Action: Get_Weight, dodijeljena naredba SIX1. Ako test ne uspije, upotrijebite tablicu pogrešaka i provjerite odabranu naredbu.

9. simulator bez fizičke vage

Otvorite Scale simulation u gornjem lijevom izborniku.
Kliknite ikonu plusa na kartici Presets.
Unesite željene podatke simulatora.
Postavite Connection type na Scale link i kliknite Save.
Generirani MID i PIN pojavljuju se na vrhu nakon spremanja.
Kliknite spremljeni simulator u Presets da biste ga povezali s oblakom.
Koristite MID i PIN simulatora u zahtjevima ScaleWebLink.

Simulator podržava razvoj i testiranje API sučelja. Prije upotrebe integracije u svojem procesu provjerite stvarnu vagu, protokol i potrebne radnje.

10. Preporuke i podrška za integraciju

Čuvajte MID i PIN na poslužiteljskoj strani; nemojte ih izlagati u javnom web-kodu ili zapisnicima.
Šaljite zahtjeve istoj vagi jedan za drugim. ERR09 označava da je komunikacija zauzeta.
Za ERR10 provjerite povezivost i odgovor vage. Nemojte naslijepo ponavljati radnje koje mijenjaju stanje: bez odgovora ne možete znati je li radnja izvršena.
Nedostupna polja tretirajte kao nedostajuće podatke, a ne 0.
Prije pohrane rezultata ili nastavka procesa provjerite uspjeh, jedinicu i potrebnu stabilnost.

Za dodatne informacije i tehničku podršku: support@scale-monitor.com.

Ova dokumentacija temelji se na ScaleWebLink v1.5. Primjeri objašnjavaju sučelje i moraju se prilagoditi vašoj konfiguraciji.

Često postavljana pitanja o ScaleWebLink

Što je ScaleWebLink?

ScaleWebLink je mrežna usluga koja komunicira s vagom putem modula CloudScaleLink koristeći REST zahtjeve i JSON odgovore.

Mogu li koristiti postojeću vagu?

Da, ako se može povezati putem modula CloudScaleLink i ako se njezin komunikacijski protokol može konfigurirati. Prije integracije provjeravamo proizvođača, model, priključak i potrebne naredbe.

Mogu li tarirati vagu iz svoje aplikacije?

Da, ako vaga i protokol podržavaju tariranje. Definirajte radnju i njezinu naredbu u sustavu Scale Monitor, a zatim pozovite radnju putem usluge ScaleWebLink.

Je li potrebna internetska veza?

Da. Dokumentirana veza koristi uslugu u oblaku i povezanu vagu ili simulator.

Mogu li testirati bez fizičke vage?

Da. Simulator Scale Monitor generira MID i PIN za testiranje. API test provjerava radnje i prikazuje odgovore.

Jesu li sva polja s podacima o masi uvijek dostupna?

Ne. net, gross, tare, unit i stability ovise o odgovoru vage i protokolu. null znači da podatak nije primljen.

ScaleWebLink · v1.5 · PRECIZ / Scale Monitor

Trebate pomoć?

Trebate pomoć sa softverom, povezivošću ili uporabom rješenja? Opišite problem kako bismo vam pomogli odrediti sljedeći korak.

Pripremite zahtjev →

Neutron i vage

Oblak i aplikacije

Integracije