Point de terminaison des requêtes

Dernière mise à jour : 16 juillet 2024

Créé pour :

  • Développeur

Exemples d’appels API

Les sections suivantes passent en revue les appels que vous pouvez effectuer à l’aide du point de terminaison /queries de l’API Query Service. Chaque appel inclut le format général d’API, un exemple de requête présentant les en-têtes requis et un exemple de réponse.

Récupération d’une liste de requêtes

Vous pouvez récupérer une liste de toutes les requêtes de votre organisation en envoyant une requête de GET au point de terminaison /queries.

Format d’API

GET /queries
GET /queries?{QUERY_PARAMETERS}
  • {QUERY_PARAMETERS} : (facultatif) paramètres ajoutés au chemin de requête configurant les résultats renvoyés dans la réponse. Plusieurs paramètres peuvent être inclus et séparés par des esperluettes (&). Les paramètres disponibles sont répertoriés ci-dessous.

Paramètres de requête

Vous trouverez ci-dessous une liste des paramètres de requête disponibles pour répertorier les requêtes. Tous ces paramètres sont facultatifs. En effectuant un appel vers ce point d’entrée sans paramètres, vous récupérerez toutes les requêtes disponibles pour votre organisation.

ParamètreDescription
orderbySpécifie le champ de référence pour le tri des résultats. Les champs created et updated sont pris en charge. Par exemple, orderby=created triera les résultats par ordre croissant de création. L’ajout d’un - devant created (orderby=-created) triera les éléments par ordre décroissant de création.
limitIndique la limite de taille de page pour contrôler le nombre de résultats inclus dans une page. (Valeur par défaut : 20)
startSpécifiez un horodatage au format ISO pour classer les résultats. Si aucune date de début n’est spécifiée, l’appel API renvoie d’abord la requête créée la plus ancienne, puis continue à répertorier les résultats plus récents.
Les horodatages ISO permettent différents niveaux de granularité dans la date et l’heure. Les horodatages ISO de base prennent le format : 2020-09-07 pour exprimer la date du 7 septembre 2020. Un exemple plus complexe serait écrit sous la forme 2022-11-05T08:15:30-05:00 et correspond au 5 novembre 2022, 8:15:30 am, heure normale de l’Est des États-Unis. Un fuseau horaire peut être fourni avec un décalage UTC et est signalé par le suffixe "Z" (2020-01-01T01:01:01Z). Si aucun fuseau horaire n’est fourni, la valeur par défaut est zéro.
propertyFiltrez les résultats en fonction des champs. Les filtres doivent être précédés d’une séquence d’échappement HTML. Des virgules sont utilisées pour combiner plusieurs ensembles de filtres. Les champs created, updated, state et id sont pris en charge. Les opérateurs > (supérieur à), < (inférieur à), >= (supérieur ou égal à), <= (inférieur ou égal à), == (égal à), != (différent de) et ~ (contient). Par exemple, id==6ebd9c2d-494d-425a-aa91-24033f3abeec renvoie toutes les requêtes avec l’identifiant spécifié.
excludeSoftDeletedIndique s’il faut inclure une requête ayant été supprimée de manière réversible. Par exemple, excludeSoftDeleted=false inclut des requêtes supprimées de manière réversible. (booléenne, valeur par défaut : true)
excludeHiddenIndique si les requêtes formulées par l’utilisateur doivent être affichées. Si cette valeur est définie sur false, cela inclut les requêtes qui ne sont pas formulées par l’utilisateur telles que les définitions CURSOR, FETCH ou les requêtes de métadonnées. (booléenne, valeur par défaut : true)
isPrevLinkLe paramètre de requête isPrevLink est utilisé pour la pagination. Les résultats de l’appel API sont triés à l’aide de leur horodatage created et de la propriété orderby. Lors de la navigation dans les pages de résultats, isPrevLink est défini sur true lors de la pagination vers l’arrière. L’ordre de la requête est alors inversé. Voir les liens "suivant" et "prev" comme exemples.

Requête

La requête suivante récupère la dernière requête créée pour votre organisation.

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

Réponse

Une réponse réussie renvoie un état HTTP 200 avec une liste de requêtes pour l’organisation spécifiée sous la forme JSON. La réponse suivante renvoie la dernière requête créée pour votre organisation.

{
    "queries": [
        {
            "isInsertInto": false,
            "request": {
                "dbName": "prod:all",
                "sql": "SELECT *\nFROM\n  accounts\nLIMIT 10\n"
            },
            "state": "SUCCESS",
            "rowCount": 0,
            "errors": [],
            "isCTAS": false,
            "version": 1,
            "id": "9957bd7f-2244-4fd5-91bc-077d7df1d8e5",
            "elapsedTime": 28,
            "updated": "2019-12-06T22:00:17.390Z",
            "client": "Adobe Query Service UI",
            "userId": "{USER_ID}",
            "created": "2019-12-06T22:00:17.362Z",
            "_links": {
                "self": {
                    "href": "https://platform.adobe.io/data/foundation/query/queries/9957bd7f-2244-4fd5-91bc-077d7df1d8e5",
                    "method": "GET"
                },
                "soft_delete": {
                    "href": "https://platform.adobe.io/data/foundation/query/queries/9957bd7f-2244-4fd5-91bc-077d7df1d8e5",
                    "method": "PATCH",
                    "body": "{ \"op\": \"soft_delete\"}"
                },
                "referenced_datasets": [
                    {
                        "id": "5b2bdd32230d4401de87397c",
                        "href": "https://platform.adobe.io/data/foundation/catalog/dataSets/5b2bdd32230d4401de87397c"
                    }
                ]
            }
        }
    ],
    "_page": {
        "orderby": "-created",
        "start": "2019-12-06T22:00:17.362Z",
        "next": "2019-08-01T00:14:21.748Z",
        "count": 1
    },
    "_links": {
        "next": {
            "href": "https://platform.adobe.io/data/foundation/query/queries?orderby=-created&start=2019-08-01T00:14:21.748Z"
        },
        "prev": {
            "href": "https://platform.adobe.io/data/foundation/query/queries?orderby=-created&start=2019-12-06T22:00:17.362Z&isPrevLink=true"
        }
    },
    "version": 1
}