DATA API užklausos

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

1. 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 - pirmiausia reikia užmegzti ryšį su duomenų baze. Užklausos į Filemaker duomenų bazes 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 į globaliu 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. Įrašų radimas

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'

Dokumentacija:

• Postman

• Filemaker API