Asortimento pozicijų statusai - DATA API

API užklausų DATA CUBE su Postman pirmi žingsniai:

Paruošti aplinką (Environment)

1.1. Parsisiųsti ir suimportuoti Postman aplinką (JSON)

1.2. Pasirinkti aplinką (1) bei nustatyti aplinkos kintamųjų reikšmes (2,3) - user, password, database, server.

1.3. Paruošta aplinka:

2. Importuoti užklausų rinkinį (Collection) į Postman

3. Siųsti užklausas į DATA CUBE

3.1. Autentifikacija (authentification)

Pirmiausia reikia užmegzti ryšį su duomenų baze. Užklausos į Filemaker API reikalauja galiojančio žetono (token). Postman pagalba jį galima gauti išsiunčiant “authentification” užklausą importuotame rinkinyje.

3.1.1. Užklausos siuntimas

cURL užklausos kodas:

curl --location --request POST 'https://test.server.lt/fmi/data/v1/databases/DATA_CUBE_4_01/sessions' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic cG9ydGFsOnRlc3RpbmlzMTIz' \
--data-raw ''

3.1.2. Užklausos rezultatas

{
    "response": {
        "token": "ed77ab8161f546d4f1d47c793221430239254ec9a819ef13c86d"
    },
    "messages": [
        {
            "code": "0",
            "message": "OK"
        }
    ]
}

Gautame rezultate “code”: “0”, bei “message”: “OK” reiškia sėkmingą žetono sugeneravimą. Jis įrašomas į globalių kintamųjų reikšmes ir bus naudojamas tolimesnėse užklausose. Žetonas galioja 15 min nuo paskutinės jį naudojusios užklausos. Po to, reikia autentifikuotis iš naujo.

3.2. Visų “Asortimento pozicijų statusai” lentelės įrašų gavimas (Get all records)

Užmezgus ryšį tolimesnis žingsnis yra išsitraukti visus duomenis iš nurodytos lentelės. Tai galima padaryti “get all records” užklausos pagalba.

Įvykdžius užklausą gaunamas rezultatas - visi lentelės duomenys JSON formatu, pvz.:

{
    "response": {
        "dataInfo": {
            "database": "DATA_CUBE",
            "layout": "Asortimento pozicijų statusai",
            "table": "Asortimento pozicijų statusai",
            "totalRecordCount": 3,
            "foundCount": 3,
            "returnedCount": 3
        },
        "data": [
            {
                "fieldData": {
                    "Unikalus ID": 149,
                    "Objekto kodas": "2501",
                    "Projekto kodas": "789",
                    "Balansinis vienetas": "A000",
                    "Statusas": "Inicijuota",
                    "Pirkimo numeris": "9108-9109",
                    "Krepšelio numeris": "1019",
                    "Pozicijos pavadinimas": "20210125 01",
                    "Objekto numeris": "1.1.",
                    "Kiekis": 1000,
                    "Mato vienetas": "lapas"
                },
                "portalData": {},
                "recordId": "73",
                "modId": "2"
            },
            {
                "fieldData": {
                    "Unikalus ID": 153,
                    "Objekto kodas": "2502",
                    "Projekto kodas": "98787",
                    "Balansinis vienetas": "A000",
                    "Statusas": "Įtraukta į planą",
                    "Pirkimo numeris": "9107",
                    "Krepšelio numeris": "1018",
                    "Pozicijos pavadinimas": "2021012502",
                    "Objekto numeris": "1.2.",
                    "Kiekis": 1000,
                    "Mato vienetas": "min."
                },
                "portalData": {},
                "recordId": "77",
                "modId": "3"
            },
            {
                "fieldData": {
                    "Unikalus ID": 262,
                    "Objekto kodas": "20210225 02",
                    "Projekto kodas": "123",
                    "Balansinis vienetas": "W000",
                    "Statusas": "Įtraukta į krepšelį",
                    "Pirkimo numeris": "",
                    "Krepšelio numeris": "1032",
                    "Pozicijos pavadinimas": "20210225 02",
                    "Objekto numeris": "1.1.",
                    "Kiekis": 1000,
                    "Mato vienetas": "objektas"
                },
                "portalData": {},
                "recordId": "107",
                "modId": "3"
            }
        ]
    },
    "messages": [
        {
            "code": "0",
            "message": "OK"
        }
    ]
}

cURL užklausa:

curl --location --request GET 'https://demo.ecocost.lt/fmi/data/v1/databases/DATA_CUBE_4_01/layouts/{{layout}}/records' \
--header 'Authorization: Bearer ed77ab8161f546d4f1d47c793221430239254ec9a819ef13c86d'

4. Postman taip pat pateikia galimybę susigeneruoti užklausų kodą kitomis kalbomis:

Detali dokumentacija:

Asortimento pozicijų statusai - DATA API

0 Comments