Accéder au contenu principal Passer au contenu complémentaire

Obtenir les enregistrements à l'aide d'une requête

Availability-noteDéprécié·e

Obtient les enregistrements de données via le conteneur de données spécifié. La requête est fournie dans le contenu demandé en JSON.

Vous pouvez également récupérer un snapshot d'un enregistrement MDM spécifique et parcourir l'historique des enregistrements. Pour plus d'informations, consultez Machine MDM à remonter dans le temps.

Requête
PUT /services/rest/data/{containerName}/query

Le corps est un langage de requête au format JSON. Le type de contenu du paramètre est application/json.

Paramètres
  • containerName : valeur String qui spécifie le nom du conteneur de données dans lequel vous souhaitez lire des enregistrements de données.
  • container : valeur String représentant le type du conteneur de données. La valeur est soit MASTER (default), soit STAGING.
  • ignoreCase : valeur booléenne qui contrôle le rejet du cas d'entité et des noms d'attributs dans la réponse JSON. Par défaut, la valeur est true, ce qui signifie que tous les noms d'entités et d'attributs dans la réponse JSON seront en lettres minuscules.
En-têtes
  • Content-Type : application/json
  • Authorization : schéma d'authentification basique
  • Accept : application/xml ou application/json
Réponse Documents des enregistrements dans le conteneur spécifié.
Statut
  • 200 OK : l'opération a bien été exécutée.
  • 400 BAD REQUEST : la requête contient un paramètre invalide, par exemple un nom de stockage invalide ou un type de stockage invalide.
  • 401 UNAUTHORIZED : la connexion échoue, l'identifiant ou le mot de passe est invalide.
  • 404 NOT FOUND : la ressource n'existe pas, par exemple l'URL du service est invalide.
  • 500 INTERNAL SERVER ERROR : autres erreurs.
Limitation Cette API REST ne supporte pas l'obtention des enregistrements par requête pour l'entité Role du conteneur de données système PROVISIONING.

Exemple de requête

{
    "select": { 
        "from": ["Product"],
        "where": {
            "gt":[
                {"field": "Product/Price"},
                {"value": "16"}
            ]   
        }
    }
}

Exemple de réponse au format XML

<results>
   <Product>
      <Picture>/imageserver/upload/TalendShop/dog.jpg</Picture>
      <Id>231035933</Id>
      <Name>partialNameUpdate1</Name>
      <Description>partialDescriptionUpdate1</Description>
      <Features>
         <Sizes>
            <Size>Small</Size>
            <Size>Medium</Size>
            <Size>Large</Size>
            <Size>X-Large</Size>
         </Sizes>
         <Colors>
            <Color>White</Color>
         </Colors>
      </Features>
      <Availability>true</Availability>
      <Price>111.00</Price>
      <Family>[14]</Family>
      <OnlineStore>Talend Shop@@http://www.cafepress.com/Talend.231035933</OnlineStore>
      <Stores/>
   </Product>
   <Product>
      <Picture>/imageserver/upload/TalendShop/tshirt.jpg?width=150&height=90&preserveAspectRatio=true</Picture>
      <Id>231035935</Id>
      <Name>partialNameUpdate3</Name>
      <Description>partialDescriptionUpdate3</Description>
      <Features>
         <Sizes>
            <Size>Medium</Size>
         </Sizes>
         <Colors>
            <Color>White</Color>
         </Colors>
      </Features>
      <Availability>false</Availability>
      <Price>333.00</Price>
      <Family>[1]</Family>
      <OnlineStore>Talend Shop@@http://www.cafepress.com/Talend.231035936</OnlineStore>
      <Stores/>
   </Product>
</results>

Exemple de réponse au format JSON

[
  {
    "product": {
      "picture": "/imageserver/upload/TalendShop/dog.jpg",
      "id": "1",
      "name": "New Name",
      "description": "Doggie t-shirt from American Apparel",
      "features": {
        "sizes": {
          "size": [
            "Small",
            "Medium",
            "Large",
            "X-Large"
          ]
        },
        "colors": {
          "color": [
            "White"
          ]
        }
      },
      "availability": "true",
      "price": "16.99",
      "family": "[14]",
      "onlinestore": "Talend Shop@@http://www.cafepress.com/Talend.231035933",
      "stores": {}
    }
  },
  {
    "product": {
      "picture": "/imageserver/upload/TalendShop/dog.jpg",
      "id": "231035933",
      "name": "Talend Dog T-Shirt",
      "description": "Doggie t-shirt from American Apparel",
      "features": {
        "sizes": {
          "size": [
            "Small",
            "Medium",
            "Large",
            "X-Large"
          ]
        },
        "colors": {
          "color": [
            "White"
          ]
        }
      },
      "availability": "true",
      "price": "16.99",
      "family": "[14]",
      "onlinestore": "Talend Shop@@http://www.cafepress.com/Talend.231035933",
      "stores": {}
    }
  },
  {
    "product": {
      "picture": "/imageserver/upload/TalendShop/spaghetti.jpg",
      "id": "231035934",
      "name": "Talend Jr. Spaghetti Tank",
      "description": "Spaghetti tank from American Apparel",
      "features": {
        "sizes": {
          "size": [
            "Small",
            "Medium",
            "Large",
            "X-Large"
          ]
        },
        "colors": {
          "color": [
            "White",
            "Light Blue",
            "Light Pink",
            "Lemon"
          ]
        }
      },
      "availability": "true",
      "price": "16.99",
      "family": "[8]",
      "onlinestore": "Talend Shop@@http://www.cafepress.com/Talend.231035934",
      "stores": {}
    }
  }
]

Cette page vous a-t-elle aidé ?

Si vous rencontrez des problèmes sur cette page ou dans son contenu – une faute de frappe, une étape manquante ou une erreur technique – dites-nous comment nous améliorer !