Catalog -gegevens filteren met behulp van queryparameters

Met de API Catalog Service kunnen reactiegegevens worden gefilterd met behulp van queryparameters voor aanvragen. Een van de beste werkwijzen voor Catalog is het gebruik van filters in alle API-aanroepen, aangezien deze de belasting van de API verminderen en de algehele prestaties verbeteren.

In dit document worden de meest gebruikte methoden voor het filteren van Catalog -objecten in de API beschreven. Men adviseert dat u dit document terwijl het lezen van de de ontwikkelaarsgids van de Catalogusvan verwijzingen voorziet om meer over te leren hoe te met Catalog API in wisselwerking te staan. Voor meer algemene informatie over Catalog Service, zie het Catalog overzicht.

Teruggestuurde objecten beperken

Met de query-parameter limit beperkt u het aantal objecten dat in een reactie wordt geretourneerd. Catalog reacties worden automatisch gemeten volgens de geconfigureerde limieten:

  • Wanneer geen parameter limit wordt opgegeven, is het maximumaantal objecten per antwoordlading 20.
  • Als voor datasetquery's observableSchema wordt aangevraagd met de parameter properties query, is het maximale aantal geretourneerde datasets 20.
  • De algemene limiet voor alle andere catalogusquery's is 100 objecten.
  • Ongeldige limit -parameters (inclusief limit=0 ) resulteren in foutreacties op 400-niveau met een overzicht van juiste bereiken.
  • Limieten of verschuivingen die worden doorgegeven als queryparameters hebben voorrang op parameters die als kopteksten worden doorgegeven.

API formaat

GET /{OBJECT_TYPE}?limit={LIMIT}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{LIMIT}
Een geheel getal dat aangeeft hoeveel objecten moeten worden geretourneerd, van 1 tot en met 100.

Verzoek

Het volgende verzoek wint een lijst van datasets terwijl het beperken van de reactie op drie voorwerpen terug.

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?limit=3 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een succesvolle reactie keert een lijst van datasets terug, die tot het aantal wordt beperkt door de limit vraagparameter wordt vermeld.

{
    "5ba9452f7de80400007fc52a": {
        "name": "Sample Dataset 1",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5ba9452f7de80400007fc52a"
    },
    "5bb276b03a14440000971552": {
        "name": "Sample Dataset 2",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5bb276b03a14440000971552"
    },
    "5bceaa4c26c115000039b24b": {
        "name": "Sample Dataset 3"
    }
}

Weergegeven eigenschappen beperken

Zelfs bij het filteren van het aantal objecten dat wordt geretourneerd met de parameter limit , kunnen de geretourneerde objecten zelf vaak meer informatie bevatten dan u eigenlijk nodig hebt. Als u de belasting van het systeem verder wilt verminderen, kunt u het beste reacties filteren en alleen de gewenste eigenschappen opnemen.

De properties -parameterfilters reageren op objecten om alleen een set opgegeven eigenschappen te retourneren. De parameter kan worden ingesteld om een of meerdere eigenschappen te retourneren.

De parameter properties kan alle objecteigenschappen op niveau accepteren. sampleKey kan worden geëxtraheerd met ?properties=subItem.sampleKey .

{
  "5ba9452f7de80400007fc52a": {
      "name": "Sample Dataset",
      "description": "Sample dataset containing important data",
      "subitem": {
          "sampleKey": "sampleValue"
      }
  }
}

API formaat

GET /{OBJECT_TYPE}?properties={PROPERTY}
GET /{OBJECT_TYPE}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
GET /{OBJECT_TYPE}/{OBJECT_ID}?properties={PROPERTY_1},{PROPERTY_2},{PROPERTY_3}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{PROPERTY}
The name of an attribute to include in the response body.
{OBJECT_ID}
De unieke id van een specifiek Catalog -object dat wordt opgehaald.

Verzoek

Het volgende verzoek wint een lijst van datasets terug. De door komma's gescheiden lijst met namen van eigenschappen die wordt geleverd onder de parameter properties geeft de eigenschappen aan die moeten worden geretourneerd in de reactie. Er wordt ook een parameter limit opgenomen die het aantal geretourneerde gegevenssets beperkt. Als de aanvraag geen parameter limit bevat, bevat de reactie maximaal 20 objecten.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?limit=4&properties=name,schemaRef' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een succesvol antwoord retourneert een lijst met Catalog -objecten waarbij alleen de gevraagde eigenschappen worden weergegeven.

{
    "Dataset1": {
        "name": "Dataset 1",
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/bc82c518380478b59a95c63e0f843121",
            "contentType": "application/vnd.adobe.xed+json;version=1"
        }
    },
    "Dataset2": {},
    "Dataset3": {
        "name": {},
    },
    "Dataset4": {
        "name": "Dataset 4",
        "schemaRef": {
            "id": "https://ns.adobe.com/{TENANT_ID}/schemas/142afb78d8b368a5ba97a6cc8fc7e033",
            "contentType": "application/vnd.adobe.xed+json;version=1"
        }
    }
}

Op basis van bovenstaande reactie kan het volgende worden afgeleid:

  • Als een object gevraagde eigenschappen mist, worden alleen de gevraagde eigenschappen weergegeven die het bevat. (Dataset1)
  • Als een object geen van de gevraagde eigenschappen bevat, wordt het weergegeven als een leeg object. (Dataset2)
  • Een dataset kan een gevraagde bezit als leeg voorwerp terugkeren als het het bezit bevat maar er geen waarde is. (Dataset3)
  • Anders, zal de dataset de volledige waarde van alle gevraagde eigenschappen tonen. (Dataset4)
NOTE
In het schemaRef bezit voor elke dataset, wijst het versieaantal op de recentste minder belangrijke versie van het schema. Zie de sectie over schema versioningin de gids XDM API voor meer informatie.

Beginindex van verschuiving van reactielijst

Met de query-parameter start verschuift u de lijst met reacties met een opgegeven getal door op nul gebaseerde nummering te gebruiken. start=2 verschuift bijvoorbeeld de reactie naar het begin van het derde weergegeven object.

Wanneer de parameter start niet aan een parameter limit is gekoppeld, is het maximale aantal geretourneerde objecten 20.

API formaat

GET /{OBJECT_TYPE}?start={OFFSET}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog-object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{OFFSET}
Een geheel getal dat het aantal objecten aangeeft waarmee de reactie moet worden verschoven.

Verzoek

Het volgende verzoek wint een lijst van datasets terug, die aan het vijfde voorwerp (start=4) compenseren en de reactie beperken tot twee teruggekeerde datasets (limit=2).

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?start=4&limit=2 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

De reactie omvat een voorwerp JSON dat twee top-level punten (limit=2) bevat, voor elke dataset en hun details (details zijn versmald in het voorbeeld). De reactie wordt verschoven door vier (start=4), betekenend zijn de getoonde datasets aantal vijf en zes chronologisch.

{
    "Dataset5": {},
    "Dataset6": {}
}

Filteren op tag

Sommige catalogusobjecten ondersteunen het gebruik van een tags -kenmerk. Tags kunnen informatie aan een object koppelen en later worden gebruikt om dat object op te halen. De keuze van de tags die u wilt gebruiken en hoe u deze wilt toepassen, is afhankelijk van uw organisatieprocessen.

Er zijn enkele beperkingen waarmee u rekening kunt houden bij het gebruik van tags:

  • De enige voorwerpen van de Catalogus die momenteel markeringen steunen zijn datasets, partijen, en verbindingen.

  • Tagnamen zijn uniek voor uw organisatie.

  • Adobe processen kunnen voor bepaalde gedragingen tags gebruiken. De namen van deze tags worden standaard voorafgegaan door "adobe". Daarom moet u deze conventie vermijden bij het declareren van labelnamen.

  • De volgende tagnamen zijn gereserveerd voor gebruik in Experience Platform en kunnen daarom niet worden gedeclareerd als tagnaam voor uw organisatie:

    • unifiedProfile: Deze tagnaam is gereserveerd voor gegevenssets die door Real-Time Customer Profile worden ingevoerd.
    • unifiedIdentity: Deze tagnaam is gereserveerd voor gegevenssets die door Identity Service worden ingevoerd.

Hieronder ziet u een voorbeeld van een gegevensset die een eigenschap tags bevat. De tags binnen die eigenschap hebben de vorm van sleutel-waardeparen, waarbij elke tagwaarde wordt weergegeven als een array met één tekenreeks:

{
    "5be1f2ecc73c1714ceba66e2": {
        "imsOrg": "{ORG_ID}",
        "tags": {
            "sampleTag": [
                "123456"
            ],
            "secondTag": [
                "sample_tag_value"
            ]
        },
        "name": "Sample Dataset",
        "description": "Same dataset containing sample data.",
        "createdUser": "{CREATED_USER}",
        "createdClient": "{CREATED_CLIENT}",
        "updatedUser": "{UPDATED_USER}",
        "version": "1.0.0",
        "created": 1541534444286,
        "updated": 1541534444286
    }
}

API formaat

Waarden voor de parameter tags hebben de vorm van sleutel-waardeparen, die het formaat {TAG_NAME}:{TAG_VALUE} gebruiken. U kunt meerdere sleutelwaardeparen opgeven in de vorm van een lijst met komma's als scheidingsteken. Wanneer veelvoudige markeringen worden verstrekt, wordt een EN verhouding verondersteld.

De parameter steunt vervangingskarakters (*) voor markeringswaarden. Een zoektekenreeks van test* retourneert bijvoorbeeld een object waar de tagwaarde begint met 'test'. Een zoektekenreeks die alleen uit een jokerteken bestaat, kan worden gebruikt om objecten te filteren op basis van het feit of ze een specifieke tag bevatten, ongeacht de waarde ervan.

GET /{OBJECT_TYPE}?tags={TAG_NAME}:{TAG_VALUE}
GET /{OBJECT_TYPE}?tags={TAG_NAME_1}:{TAG_VALUE_1},{TAG_NAME_2}:{TAG_VALUE_2}
GET /{OBJECT_TYPE}?tags={TAG_NAME}:{TAG_VALUE}*
GET /{OBJECT_TYPE}?tags={TAG_NAME}:*
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
{TAG_NAME}
De naam van de tag waarop moet worden gefilterd.
{TAG_VALUE}
De waarde van de tag waarop moet worden gefilterd. Steunt vervangingskarakters (*).

Verzoek

Het volgende verzoek wint een lijst van datasets terug, filtrerend door één markering die een specifieke waarde EN de tweede markering die aanwezig is.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?tags=sampleTag:123456,secondTag:* \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een succesvol antwoord retourneert een lijst met gegevenssets die sampleTag met de waarde "123456" EN secondTag bevatten, met een willekeurige waarde. Tenzij ook een limiet is opgegeven, bevat het antwoord maximaal 20 objecten.

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 1",
            "created": 1533539550237,
            "updated": 1533539552416,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
            "tags": {
                "sampleTag": [
                    "123456"
                ],
                "secondTag": [
                    "Example tag value"
                ]
            },
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.0",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 2",
            "created": 1533539550237,
            "updated": 1533539552416,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
            "tags": {
                "sampleTag": [
                    "123456"
                ],
                "secondTag": [
                    "A different tag value"
                ],
                "anotherTag": [
                    "2.0"
                ]
            },
    }
}

Filteren op datumbereik

Sommige eindpunten in de API van Catalog hebben vraagparameters die voor gerangschikte vragen, het vaakst in het geval van data toestaan.

API formaat

GET /batches?createdAfter={TIMESTAMP_1}&createdBefore={TIMESTAMP_2}
Parameter
Beschrijving
{TIMESTAMP }
Een geheel getal in tijd in Unix Epoch.

Verzoek

Met het volgende verzoek wordt een lijst opgehaald met batches die in de maand april 2019 zijn gemaakt.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/batches?createdAfter=1554076800000&createdBefore=1556668799000' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een geslaagde reactie bevat een lijst met Catalog -objecten die binnen het opgegeven datumbereik vallen. Tenzij ook een limiet is opgegeven, bevat het antwoord maximaal 20 objecten.

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 1",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.0",
            "imsOrg": "{ORG_ID}",
            "name": "Example Dataset 2",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

Sorteren op eigenschap

Met de parameter orderBy query kunt u reactiegegevens sorteren (ordenen) op basis van een opgegeven eigenschapswaarde. Deze parameter vereist een "richting" (asc voor het stijgen of desc voor het dalen), gevolgd door een dubbelepunt (:) en dan een bezit om de resultaten door te sorteren. Als er geen richting is opgegeven, wordt de standaardrichting oplopend.

U kunt meerdere sorteereigenschappen opgeven in een lijst met komma's als scheidingsteken. Als de eerste sorteereigenschap meerdere objecten produceert die dezelfde waarde voor die eigenschap bevatten, wordt de tweede sorteereigenschap gebruikt om die overeenkomende objecten verder te sorteren.

Neem bijvoorbeeld de volgende query: orderBy=name,desc:created . De resultaten worden in oplopende volgorde gesorteerd op basis van de eerste sorteereigenschap, name . Wanneer meerdere records dezelfde name -eigenschap delen, worden die overeenkomende records vervolgens gesorteerd op de tweede sorteereigenschap, created . Als geen geretourneerde records dezelfde name delen, wordt de sortering niet beïnvloed door de eigenschap created .

API formaat

GET /{OBJECT_TYPE}?orderBy=asc:{PROPERTY_NAME}
GET /{OBJECT_TYPE}?orderBy=desc:{PROPERTY_NAME}
GET /{OBJECT_TYPE}?orderBy={PROPERTY_NAME_1},desc:{PROPERTY_NAME_2}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog-object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{PROPERTY_NAME}
De naam van een eigenschap waarop de resultaten moeten worden gesorteerd.

Verzoek

Met het volgende verzoek wordt een lijst opgehaald met gegevenssets die zijn gesorteerd op hun eigenschap name . Als om het even welke datasets het zelfde name delen, zullen die datasets beurtelings door hun updated bezit in dalende orde worden bevolen.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?orderBy=name,desc:updated' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een geslaagde reactie bevat een lijst met Catalog -objecten die worden gesorteerd op basis van de parameter orderBy . Tenzij ook een limiet is opgegeven, bevat het antwoord maximaal 20 objecten.

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "0405",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.3",
            "imsOrg": "{ORG_ID}",
            "name": "AAM Dataset",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5cd3a129ec106214b722a939": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "AAM Dataset",
            "created": 1554028394852,
            "updated": 1554130582960,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

Filteren op eigenschap

Catalog biedt twee methoden voor het filteren op eigenschap, die nader worden beschreven in de volgende secties:

  • Gebruikend eenvoudige filters: Filter door of een specifiek bezit een specifieke waarde aanpast.
  • Gebruikend de bezitsparameter: Gebruik voorwaardelijke uitdrukkingen aan filter gebaseerd of een bezit bestaat, of als de waarde van een bezit aanpast, benadert, of met een andere gespecificeerde waarde of regelmatige uitdrukking vergelijkt.

Eenvoudige filters gebruiken using-simple-filters

Met eenvoudige filters kunt u reacties filteren op basis van specifieke eigenschapswaarden. Een eenvoudig filter heeft de vorm van {PROPERTY_NAME}={VALUE}.

De query name=exampleName retourneert bijvoorbeeld alleen objecten waarvan de eigenschap name de waarde 'exampleName' bevat. Door contrast, keert de vraag name=!exampleName slechts voorwerpen terug het waarvan name bezit niet "exampleName" is.

Bovendien ondersteunen eenvoudige filters de mogelijkheid om te zoeken naar meerdere waarden voor één eigenschap. Wanneer de veelvoudige waarden worden verstrekt, keert de reactie voorwerpen terug het waarvan bezit om het even welk van de waarden in de verstrekte lijst aanpast. U kunt een multi-waardevraag omkeren door a ! karakter aan de lijst vooraf te bepalen, terugkerend slechts voorwerpen de waarvan bezitswaarde niet in de verstrekte lijst is (bijvoorbeeld, name=!exampleName,anotherName).

API formaat

GET /{OBJECT_TYPE}?{PROPERTY_NAME}={VALUE}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}=!{VALUE}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}={VALUE_1},{VALUE_2},{VALUE_3}
GET /{OBJECT_TYPE}?{PROPERTY_NAME}=!{VALUE_1},{VALUE_2},{VALUE_3}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{PROPERTY_NAME}
De naam van de eigenschap waarop u wilt filteren.
{VALUE}
Een eigenschapwaarde die bepaalt welke resultaten moeten worden opgenomen (of uitgesloten, afhankelijk van de query).

Verzoek

Het volgende verzoek wint een lijst van datasets terug, gefiltreerd om slechts datasets te omvatten de waarvan name bezit een waarde van "exampleName"of "anotherName"heeft.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?name=exampleName,anotherName' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een geslaagde reactie bevat een lijst met gegevenssets, exclusief gegevenssets waarvan name "exampleName" of "anotherName" is. Tenzij ook een limiet is opgegeven, bevat het antwoord maximaal 20 objecten.

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.0.2",
            "imsOrg": "{ORG_ID}",
            "name": "exampleName",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.3",
            "imsOrg": "{ORG_ID}",
            "name": "anotherName",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

De parameter property gebruiken using-the-property-parameter

De query-parameter property biedt meer flexibiliteit voor op eigenschappen gebaseerde filtering dan eenvoudige filters. Naast het filtreren gebaseerd op of een bezit een specifieke waarde heeft, kan de property parameter andere vergelijkingsexploitanten (zoals "meer-dan" (>) en "minder-dan" (<)) evenals regelmatige uitdrukkingen gebruiken om door bezitswaarden te filtreren. Het kan ook filteren door of een eigenschap bestaat, ongeacht de waarde ervan.

De parameter property kan alle objecteigenschappen op niveau accepteren. sampleKey kan worden gebruikt voor filtering met ?properties=subItem.sampleKey .

{
  "5ba9452f7de80400007fc52a": {
      "name": "Sample Dataset",
      "description": "Sample dataset containing important data",
      "subitem": {
          "sampleKey": "sampleValue"
      }
  }
}

API formaat

GET /{OBJECT_TYPE}?property={CONDITION}
Parameter
Beschrijving
{OBJECT_TYPE}

Het type Catalog -object dat moet worden opgehaald. Geldige objecten zijn:

  • batches
  • dataSets
  • dataSetFiles
{CONDITION}
Een voorwaardelijke expressie die aangeeft voor welke eigenschap query moet worden uitgevoerd en hoe de waarde ervan moet worden geëvalueerd. Hieronder vindt u voorbeelden.

De waarde van de parameter property ondersteunt verschillende soorten voorwaardelijke expressies. In de volgende tabel wordt de basissyntaxis voor ondersteunde expressies beschreven:

Symbool(en)
Beschrijving
Voorbeeld
(Geen)
Wanneer de eigenschapnaam wordt opgegeven zonder operator, worden alleen objecten geretourneerd waar de eigenschap bestaat, ongeacht de waarde ervan.
property=name
!
Het voorschrijven van "!"aan de waarde van a property parameter keert slechts voorwerpen terug waar het bezit niet bestaat.
property=!name
~
Retourneert alleen objecten waarvan de eigenschapswaarden (tekenreeks) overeenkomen met een reguliere expressie die wordt opgegeven na het tilde-symbool (~).
property=name~^example
==
Retourneert alleen objecten waarvan de eigenschapswaarden exact overeenkomen met de tekenreeks die wordt opgegeven na het symbool double-equals (==).
property=name==exampleName
!=
Keert slechts voorwerpen terug de waarvan bezitswaarden niet koord aanpassen dat na het symbool niet-evenaart (!=) wordt verstrekt.
property=name!=exampleName
<
Retourneert alleen objecten waarvan de eigenschapswaarden kleiner zijn dan (maar niet gelijk zijn aan) een opgegeven hoeveelheid.
property=version<1.0.0
<=
Retourneert alleen objecten waarvan de eigenschapswaarden kleiner zijn dan (of gelijk zijn aan) een opgegeven hoeveelheid.
property=version<=1.0.0
>
Retourneert alleen objecten waarvan de eigenschapswaarden groter zijn dan (maar niet gelijk zijn aan) een opgegeven hoeveelheid.
property=version>1.0.0
>=
Retourneert alleen objecten waarvan de eigenschapswaarden groter zijn dan (of gelijk zijn aan) een opgegeven hoeveelheid.
property=version>=1.0.0
NOTE
De eigenschap name ondersteunt het gebruik van een jokerteken * als de volledige zoektekenreeks of als onderdeel ervan. Jokertekens komen overeen met lege tekens, zodat de zoektekenreeks te*st overeenkomt met de waarde 'test'. Sterretjes worden voorkomen door ze te verdubbelen (**). Een dubbele asterisk in een zoektekenreeks staat voor één sterretje als letterlijke tekenreeks.

Verzoek

Het volgende verzoek zal om het even welke datasets met een versieaantal groter dan 1.0.3 terugkeren.

curl -X GET \
  https://platform.adobe.io/data/foundation/catalog/dataSets?property=version>1.0.3 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

Reactie

Een succesvolle reactie bevat een lijst met datasets waarvan de versienummers groter zijn dan 1.0.3. Tenzij ook een limiet is opgegeven, bevat het antwoord maximaal 20 objecten.

{
    "5b67f4dd9f6e710000ea9da4": {
            "version": "1.1.2",
            "imsOrg": "{ORG_ID}",
            "name": "sampleDataset",
            "created": 1554930967705,
            "updated": 1554931119718,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5b1e3c867e6d2600003d5b49": {
            "version": "1.0.6",
            "imsOrg": "{ORG_ID}",
            "name": "exampleDataset",
            "created": 1554974386247,
            "updated": 1554974386268,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    },
    "5cd3a129ec106214b722a939": {
            "version": "1.0.4",
            "imsOrg": "{ORG_ID}",
            "name": "anotherDataset",
            "created": 1554028394852,
            "updated": 1554130582960,
            "createdClient": "{API_KEY}",
            "createdUser": "{USER_ID}",
            "updatedUser": "{USER_ID}",
    }
}

Meerdere filters combineren

Met een en-teken (&) kunt u meerdere filters combineren in één aanvraag. Wanneer de extra voorwaarden aan een verzoek worden toegevoegd, EN verhouding wordt verondersteld.

API formaat

GET /{OBJECT_TYPE}?{FILTER_1}={VALUE}&{FILTER_2}={VALUE}&{FILTER_3}={VALUE}
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676