ABOUT API

Shatlygin&Co Serial Number Identification Service

ℹ General

The service allows you to identify the products of the Shatlygin&Co enterprise by serial number according to the in-plant database and carry out a targeted search for the presence of verification in the FGIS ARSHIN database.

📥 Request

You may make GET request to:
https://sh-sni.shatlygin.ru/sninfo?sn={SERIAL_NUMBER}&arshin=true&year={VERIFICATION_YEAR}

☑ Request parameters sn={SERIAL_NUMBER} is the serial number of the device to be found. (For example: sn=AKH8715 or sn=akh8715)

☑ Request parameters arshin=true is an optional parameter that enables automatic search is FGIS ARSHIN.
If the parameter is not specified or is arshin=false, then the search in the ARSHIN database is not performed and the serial number is identified only by the in-plant database.

☑ Request parameters year={VERIFICATION_YEAR} is an optional parameter that specify the verification year for search.
{VERIFICATION_YEAR} is the year in yyyy format (For example: year=2021 or year=2022). If parameter is missing in GET request or year is before of manufacturing year, then the year of verification is automatically assumed to the manufacturing year.

📤 Response

Response is JSON file with the following structure:

{
"status": "OK", - response status [NULL_PARAM_SERIAL_NUMBER, INVALID_SERIAL_NUMBER, NO_BATCH, NUMBER_NOT_EXIST, OK]
"arshinMode": "true", - parameter from request
"code": "AKH", - serial number CODE (SERIES)
"number": "8715", - serial number NUMBER in SERIES
"exist": true, - checking for the existence of a number within a series
"closed": true, - batch closing checking
"issue": "4Q-2021", - quarter and year of production
"miType": "ТТЖ-Х", - type of production
"miChannels": [{ - product measurement channels list
"param": "TEMPERATURE", - measuring parameter [TEMPERATURE, DENSITY, HUMIDITY]
"unit": "CELSIUS", - measuring unit [KG_M, VOL_P, MASS_P, EOP, API, KG_L, G_SM, RH_P, CELSIUS;]
"rangeFrom": -30, - lower limit value
"rangeTo": 40, - upper limit value
"discret": 1, - scale division
"error": 1, - instrument measurement error
"gradtemp": 20 - graduation temperature *actual for only DENSITY param
}],
"miStandarts": ["ТУ 26.51.51-003-05664383-2017"], - standards to which the device meets
"miRegistry": "69578-17",- registry number in fundmetrology
"miRegistryLink": "https://fgis.gost.ru/fundmetrology/registry/4/items/383714", - registry link
"arshinSelectStatus": "ONE", - search status in the ARSHIN [ERROR, NONE, ONE, MANY]
"date": "2021-12-16T10:25:46.171+00:00", - time stamp of response
"fgis": { - ARSHIN JSON as is. NULL if arshin=false or arshinSelectStatus=ERROR
"response": { - RESPONSE BODY
"docs": [{- list of seached documents
"mi.mitnumber": "69578-17", - registry number in fundmetrology
"valid_date": "2024-11-11T00:00:00Z", - date of completion of verification
"result_docnum": "С-ВА/12-11-2021/114060144",- certificate / notification numbern
"result_text": "Пригодно",- certificate / notification number
"mi.mitype": "ТТЖ", - type of production
"org_title": "ФБУ \"КУРСКИЙ ЦСМ\"", - verification organization
"applicability": true, - applicability
"mi.number": "AKH8715", - seached number
"mi.modification": "ТТЖ-Х", - modification of production
"mi.mititle": "Термометры технические жидкостные", - product title
"vri_id": "1-114060144", - verification ID
"verification_date": "2021-11-12T00:00:00Z"- verification date
}],
"numFound": 1, - number of seached documents in selection
"start": 0 - start document index
},
"responseHeader": { - RESPONSE HEADER
"QTime": 697, - ARSHIN query time in milliseconds
"params": {
"q": "*",
"fl": "vri_id,org_title,mi.mitnumber,mi.mititle,mi.mitype,mi.modification,mi.number,verification_date,valid_date,applicability,result_docnum,result_text",
"start": "0",
"fq": [- search filtered query
"mi.number:AKH8715 AKH8715",- serial number
"verification_year:2021",- verification year
"mi.modification:*ТТЖ*",- modification
"mi.mitnumber:*69578-17*"- registry
],
"sort": "verification_date desc,org_title asc", - sorting parameters
"rows": "30" - maximum documents in selection
},
"status": 0
}
},
"fgisLink": "https://fgis.gost.ru/fundmetrology/cm/results/1-114060144" - direct link for ARSHIN select result
}

JSON samples



{
    "status": "OK",
    "arshinMode": "true",
    "code": "AKH",
    "number": "8715",
    "exist": true,
    "closed": true,
    "issue": "4Q-2021",
    "miType": "ТТЖ-Х",
    "miChannels": [{
            "param": "TEMPERATURE",
            "unit": "CELSIUS",
            "rangeFrom": -30,
            "rangeTo": 40,
            "discret": 1,
            "error": 1,
            "gradtemp": 20
        }
    ],
    "miStandarts": [
        "ТУ 26.51.51-003-05664383-2017"
    ],
    "miRegistry": "69578-17",
    "miRegistryLink": "https://fgis.gost.ru/fundmetrology/registry/4/items/383714",
    "arshinSelectStatus": "ONE",
    "date": "2021-12-16T10:25:46.171+00:00",
    "fgis": {
        "response": {
            "docs": [{
                    "mi.mitnumber": "69578-17",
                    "valid_date": "2024-11-11T00:00:00Z",
                    "result_docnum": "С-ВА/12-11-2021/114060144",
                    "result_text": "Пригодно",
                    "mi.mitype": "ТТЖ",
                    "org_title": "ФБУ \"КУРСКИЙ ЦСМ\"",
                    "applicability": true,
                    "mi.number": "AKH8715",
                    "mi.modification": "ТТЖ-Х",
                    "mi.mititle": "Термометры технические жидкостные",
                    "vri_id": "1-114060144",
                    "verification_date": "2021-11-12T00:00:00Z"
                }
            ],
            "numFound": 1,
            "start": 0
        },
        "responseHeader": {
            "QTime": 697,
            "params": {
                "q": "*",
                "fl": "vri_id,org_title,mi.mitnumber,mi.mititle,mi.mitype,mi.modification,mi.number,verification_date,valid_date,applicability,result_docnum,result_text",
                "start": "0",
                "fq": [
                    "mi.number:AKH8715 AKH8715",
                    "verification_year:2021",
                    "mi.modification:*ТТЖ*",
                    "mi.mitnumber:*69578-17*"
                ],
                "sort": "verification_date desc,org_title asc",
                "rows": "30"
            },
            "status": 0
        }
    },
    "fgisLink": "https://fgis.gost.ru/fundmetrology/cm/results/1-114060144"
}



{
    "status": "NUMBER_NOT_EXIST",
    "arshinMode": "false",
    "code": "AAQ",
    "number": "101",
    "exist": false,
    "closed": true,
    "issue": "3Q-2021",
    "miType": "АОН-2",
    "miChannels": [{
            "param": "DENSITY",
            "unit": "KG_M",
            "rangeFrom": 1160,
            "rangeTo": 1240,
            "discret": 1,
            "error": 1,
            "gradtemp": 20
        }
    ],
    "miStandarts": ["ГОСТ 18481-81", "ДСТУ ГОСТ 18481:2009"],
    "miRegistry": "69567-17",
    "miRegistryLink": "https://fgis.gost.ru/fundmetrology/registry/4/items/383702",
    "arshinSelectStatus": null,
    "date": "2021-12-27T16:32:20.363+00:00",
    "fgis": null,
    "fgisLink": null
}



{
    "status": "NO_BATCH",
    "arshinMode": "false",
    "code": null,
    "number": null,
    "exist": null,
    "closed": null,
    "issue": null,
    "miType": null,
    "miChannels": null,
    "miStandarts": null,
    "miRegistry": null,
    "miRegistryLink": null,
    "arshinSelectStatus": null,
    "date": null,
    "fgis": null,
    "fgisLink": null
}

⏱ Request execution time

Thanks to a carefully designed target request, which includes all key filters, the request will be executed as quickly and accurately as possible.

However, when the search in ARSHIN is enabled (arshin=true), the query execution time directly depends on the performance and workload of the resource https://fgis.gost.ru/fundmetrology/.

Typically, the query execution time is between 0.3 and 30 seconds.

🔧 Development and support

This page is the only reliable source of information about the resource API.

All updates and changes in the service will be displayed on this page.

Last publication date: 27/12/2021

🔄 Contacts for feedback

✉ email: software@shatlygin.com