Action d'API personnalisée

Effectuer un appel HTTP personnalisé et authentifié vers l'API Shopify.

Remarque :

Consulter la Shopifydocumentation destinée aux développeurs.

Options

Champ Définition Type Obligatoire

Champ	Définition	Type	Obligatoire
Type de requête	Voici les méthodes de requête HTTP prises en charge, ou verbes HTTP, dans un appel API personnalisé (voir Méthodes de requête HTTP). `GET` : Récupère des données d'un serveur web en fonction des paramètres. Cette méthode demande une représentation de la ressource spécifiée. Si une requête réussit, un message de réponse `200 (OK)` est retourné avec le contenu demandé. `POST` : Envoie des données à un serveur web en fonction des paramètres, par exemple, charger un fichier. Plusieurs requêtes POST peuvent aboutir à un résultat différent d'un seul POST. Soyez prudent pour éviter d'envoyer plusieurs requêtes POST par inadvertance. Si une requête réussit, un message de réponse `200 (OK)` est retourné. `PUT` : Envoie des données à stocker à un emplacement spécifique sur un serveur web en fonction des paramètres, comme charger un fichier. Contrairement aux requêtes POST, les requêtes PUT sont idempotentes. Pour les requêtes réussies, le résultat d'une seule requête PUT est le même que plusieurs requêtes PUT identiques. Si une requête réussit, un message de réponse `200 (OK)`, `201 (Created)` ou `204 (No Content)` est retourné. `PATCH` : Applique des modifications partielles à une ressource sur un serveur web en fonction des paramètres. PATCH n'est pas idempotente. Plusieurs requêtes PATCH pourraient avoir des conséquences non souhaitées. Si un PATCH réussit, un message de réponse `200 (OK)` ou `204 (No Content)` est retourné. `DELETE` : Supprime la ressource spécifiée si elle existe du serveur web en fonction des paramètres. Si un DELETE réussit, un message de réponse `200 (OK)` est retourné.	Liste déroulante	TRUE

Type de requête

Voici les méthodes de requête HTTP prises en charge, ou verbes HTTP, dans un appel API personnalisé (voir Méthodes de requête HTTP).

GET : Récupère des données d'un serveur web en fonction des paramètres. Cette méthode demande une représentation de la ressource spécifiée. Si une requête réussit, un message de réponse 200 (OK) est retourné avec le contenu demandé.
POST : Envoie des données à un serveur web en fonction des paramètres, par exemple, charger un fichier. Plusieurs requêtes POST peuvent aboutir à un résultat différent d'un seul POST. Soyez prudent pour éviter d'envoyer plusieurs requêtes POST par inadvertance. Si une requête réussit, un message de réponse 200 (OK) est retourné.
PUT : Envoie des données à stocker à un emplacement spécifique sur un serveur web en fonction des paramètres, comme charger un fichier. Contrairement aux requêtes POST, les requêtes PUT sont idempotentes. Pour les requêtes réussies, le résultat d'une seule requête PUT est le même que plusieurs requêtes PUT identiques. Si une requête réussit, un message de réponse 200 (OK), 201 (Created) ou 204 (No Content) est retourné.
PATCH : Applique des modifications partielles à une ressource sur un serveur web en fonction des paramètres. PATCH n'est pas idempotente. Plusieurs requêtes PATCH pourraient avoir des conséquences non souhaitées. Si un PATCH réussit, un message de réponse 200 (OK) ou 204 (No Content) est retourné.
DELETE : Supprime la ressource spécifiée si elle existe du serveur web en fonction des paramètres. Si un DELETE réussit, un message de réponse 200 (OK) est retourné.

Liste déroulante

TRUE

Entrée

Champ	Définition	Type	Obligatoire
URL liée	L'adresse (URL) du serveur Web que vous essayez d'appeler. Spécifiez l'URL liée comme suit : `/{insert_remaining_URL}`. Vous pouvez définir les paramètres de requête dans l'URL relative à l'aide du caractère « ? », ou les définir sous forme de paires clé-valeur dans le champ Requête. Par exemple, pour le point de terminaison de l'API Shopify, `https://domain-name.myshopify.com/admin/customers.json`, l'URL relative est `/admin/customers.json`. Remarque : Si vous indiquez une version API dans votre URL relative, Shopify doit avoir publié cette version au cours des 12 derniers mois. Si vous recevez une erreur, vous devez mettre à jour la version dans votre URL relative et supprimer toute charge obsolète. Sans version API explicite, vous interagissez toujours avec la version valide la plus ancienne de l'API Shopify.	Texte	TRUE
Requête	Indiquez tout paramètre de requête supplémentaire qui doit être inclus, au format de l'objet (paires clé-valeur).	Objet	FALSE
En-têtes	Indiquez les en-têtes requis en plus de `authorization` ou de `content-type` (ce connecteur gère déjà ces en-têtes).	Objet	FALSE
Corps	Spécifiez un corps de requête au format JSON. Pris en charge uniquement pour les requêtes `POST`, `PUT`et `PATCH`. Remarque : La carte d'action API personnalisée renvoie une erreur si vous utilisez l'un de ces attributs obsolète dans le corps de la requête : `value_type` `valueType` `accepts_marketing` `accepts_marketing_updated_at` `marketing_opt_in_level`	Objet	FALSE

Sortie

Champ	Définition	Type
Réponse
Code de statut	Résultat de l'opération. Le connecteur retourne un code de statut HTTP qui indique si l'action effectuée par la carte a réussi ou échoué. Par exemple : Un code de statut `201 Created` indique un succès où une nouvelle ressource a été créée. Une erreur `403 Forbidden` indique que la requête HTTP n'a pas été traitée parce que les permissions nécessaires étaient manquantes. Pour une liste complète des codes de statut possibles, voir Codes de statut HTTP.	Nombre
En-têtes	Contexte détaillé du code de statut, sans lien avec le corps de la sortie. Les en-têtes de réponse dépendent de l'option de requête HTTP sélectionnée. Tous les en-têtes ne sont pas des en-têtes de réponse. Ceci est semblable à `{"Content-type":"application/json"}`.	Objet
Corps	Données retournées par votre requête HTTP sélectionnée. Par exemple, les données d'une requête `GET`.	Objet