Bronnen zoeken in de Reactor-API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Onderwerpen:

Gemaakt voor:

Ontwikkelaar

Met het /search -eindpunt in de Reactor-API kunt u gestructureerde query's maken voor opgeslagen bronnen. Dit document bevat voorbeelden van verschillende zoekopdrachten voor verschillende veelvoorkomende gebruiksgevallen.

NOTE

Alvorens deze gids te lezen, gelieve te verwijzen naar de gids van het onderzoekseindpuntvoor informatie over toegelaten vraagsyntaxis en andere gebruiksrichtlijnen.

Basisquery-strategieën

In de volgende voorbeelden worden enkele basisbeginselen getoond voor het gebruik van de zoekfunctionaliteit van de API.

Zoeken in meerdere velden

U kunt zoeken in meerdere velden door jokertekens in de veldnaam te gebruiken. Als u bijvoorbeeld wilt zoeken in meerdere kenmerkvelden, gebruikt u attributes.* als veldnaam.

{
  "data": {
    "query": {
      "attributes.*": {
        "value": "evar7"
      }
    }
  }
}

IMPORTANT

Doorgaans moeten de zoekwaarden overeenkomen met het type gegevens dat wordt doorzocht. Een querywaarde van evar7 voor een geheel-getalveld zou bijvoorbeeld mislukken. Wanneer het zoeken over veelvoudige gebieden, wordt het vraagtype vereist om fouten te vermijden, maar kan ongewenste resultaten veroorzaken.

De vragen van het werkingsgebied aan specifieke middeltypes

U kunt een zoekopdracht uitbreiden naar een specifiek brontype door resource_types op te geven in het verzoek. Als u bijvoorbeeld wilt zoeken in data_elements en rule_components :

{
  "data": {
    "from": 0,
    "size": 25,
    "query": {
      "attributes.display_name": {
        "value": "Performance"
      }
    },
    "resource_types": [
      "data_elements",
      "rule_components"
    ]
  }
}

Reacties sorteren

De eigenschap sort kan worden gebruikt om reacties te sorteren. Als u bijvoorbeeld op created_at wilt sorteren met Nieuwste eerst:

{
  "data": {
    "from": 0,
    "size": 25,
    "query": {
      "attributes.display_name": {
        "value": "Performance"
      }
    },
    "sort": [
      {
        "attributes.created_at": "desc"
      }
    ],
    "resource_types": [
      "data_elements",
      "rule_components"
    ]
  }
}

Algemene zoekvoorbeelden

In het volgende voorbeeld worden extra gebruikelijke zoekpatronen getoond.

Elke bron met een specifieke naam

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "attributes.name": {
              "value": "Adobe"
            }
          }
        }
      }'

Elke bron die verwijst naar "evar7"

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "attributes.*": {
              "value": "evar7"
            }
          }
        }
      }'

De elementen van gegevens van een "douane-code"afgevaardigde type

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "attributes.delegate_descriptor_id": {
              "value": "custom-code"
            }
          },
          "resource_types": ["data_elements"]
        }
      }'

Regelcomponenten die verwijzen naar een specifiek gegevenselement

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "attributes.settings": {
              "value": "myDataElement8"
            }
          },
          "resource_types": ["rule_components"]
        }
      }'

Regels in een specifieke eigenschap

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "relationships.property.data.id": {
              "value": "PR3cab070a9eb3423894e4a3038ef0e7b7"
            }
          },
          "resource_types": ["rules"]
        }
      }'

Een bron zoeken op ID

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "id": {
              "value": "PR3cab070a9eb3423894e4a3038ef0e7b7"
            }
          }
        }
      }'

Een zoekopdracht uitvoeren met de term "OR"-logica

curl -X POST \
  https://reactor.adobe.io/search \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H "Content-Type: application/vnd.api+json" \
  -H 'Accept: application/vnd.api+json;revision=1' \
  -d '{
        "data": {
          "query": {
            "attributes.display_name": {
              "value": "My Rule Holiday Sale",
              "value_operator: "OR"
            }
          }
        }
      }'

recommendation-more-help

12b4e4a9-5028-4d88-8ce6-64a580811743