Katalogobjekte auflisten

Sie können über einen einzigen API-Aufruf eine Liste aller verfügbaren Objekte eines bestimmten Typs abrufen. Es empfiehlt sich, Filter einzubeziehen, um die Größe der Antwort beschränken.

API-Format

GET /{OBJECT_TYPE}
GET /{OBJECT_TYPE}?{FILTER}={VALUE}&{FILTER_2}={VALUE}
Parameter
Beschreibung
{OBJECT_TYPE}

Der Typ Catalog aufzulistenden Objekts. Gültige Objekte sind:

  • batches
  • dataSets
  • dataSetFiles
{FILTER}
Ein Abfrageparameter, mit dem die in der Antwort zurückgegebenen Ergebnisse gefiltert werden. Mehrere Parameter werden durch das kaufmännische Und-Zeichen (&) getrennt. Weiterführende Informationen finden Sie im Handbuch zum Filtern von Katalogdaten.

Anfrage

Die unten stehende Musteranfrage ruft eine Liste von Datensätzen ab, mit einem limit-Filter, der die Antwort auf fünf Ergebnisse reduziert, und einem properties-Filter, der die für die einzelnen Datensätze angezeigten Eigenschaften begrenzt.

curl -X GET \
  'https://platform.adobe.io/data/foundation/catalog/dataSets?limit=5&properties=name,description,files' \
  -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}'

Antwort

Eine erfolgreiche Antwort gibt eine Liste von Catalog-Objekten in Form von Schlüssel-Wert-Paaren zurück, die nach den in der Anfrage angegebenen Abfrageparametern gefiltert werden. Für jedes Schlüssel-Wert-Paar stellt der Schlüssel eine eindeutige Kennung für das betreffende Catalog-Objekt dar, die dann in einem anderen Aufruf verwendet werden kann, um dieses spezifische Objekt anzuzeigen um weitere Details zu erhalten.

NOTE
Wenn ein zurückgegebenes Objekt keine oder mehrere der angeforderten Eigenschaften enthält, die in der properties Abfrage angegeben werden, gibt die Antwort nur die angeforderten Eigenschaften zurück, die es enthält, wie in Sample Dataset 3 und Sample Dataset 4 unten dargestellt.
{
    "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"
    },
    "5bda3a4228babc0000126377": {
        "name": "Sample Dataset 4",
        "files": "@/dataSetFiles?dataSetId=5bda3a4228babc0000126377"
    },
    "5bde21511dd27b0000d24e95": {
        "name": "Sample Dataset 5",
        "description": "Description of dataset.",
        "files": "@/dataSetFiles?dataSetId=5bde21511dd27b0000d24e95"
    }
}
recommendation-more-help
c5c02be6-79a3-4a2f-b766-136bffe8b676