Modele de lettre pour demande de lots

Nous vous fournissons deux méthodes pour vous authentifier avec notre API: OAuth 2,0 et HTTP Basic auth. selon le cas d`utilisation et les exigences, l`une ou l`autre méthode peut être utilisée pour demander des données PlanGrid. Pour la plupart des applications, nous vous recommandons d`utiliser OAuth 2,0. S`il vous plaît noter que si vous fournissez un tableau mal formé, un tableau avec trop de demandes, ou un tableau sans demandes, vous recevrez une réponse 400 pour la demande de lot au lieu d`une réponse comme celle ci-dessus. Consultez les différentes erreurs dans l`exemple envoyer une requête par lot. Nombre total de demandes du type indiqué autorisées dans l`intervalle. Les demandes doivent être fournies dans un tableau codé en JSON dans le format suivant attaché le paramètre requests dans un corps POST seul «path» est requis pour les requêtes HTTP GET. «path» représente le chemin d`accès de l`API pour la méthode. «Ref» permet de marquer une requête dans un lot avec une étiquette que vous pouvez associer à sa réponse dans le corps de la réponse de lot.

Cela sera par défaut le «chemin» fourni. Vous pouvez également fournir une clé «params» avec un objet JSON représentant les paramètres fournis pour la demande. À ce moment, seules les requêtes HTTP GET, DELETE et POST sont prises en charge. Vous pouvez spécifier l`une de ces propriétés en tant que propriété «Method» de la requête. Les méthodes nécessitant une forme multipartie POST ne sont actuellement pas prises en charge. Vous pouvez également fournir des en-têtes sur une base par demande en ajoutant un champ «en-têtes» à l`objet JSON qui représente la demande en tant que paires de valeurs de clé de chaînes. Pour utiliser HTTP Basic auth, vous devez envoyer votre clé API à chaque demande à l`API PlanGrid. Mettez votre clé API en tant que nom d`utilisateur de base auth et laissez le mot de passe vide: c`est beaucoup moins que le «pouvez-vous me donner cette lettre? Maintenant, pouvez-vous me donner cette lettre? Maintenant pouvez-vous me donner cette lettre? «les demandes qui doivent se produire quand vous le faites à l`ancienne façon. Et cela signifie deux choses. Un: vous en tant qu`utilisateur a dû faire moins de demandes. Deux: l`ordinateur doit traiter moins de demandes.

C`est plus propre; Il faut moins d`efforts pour commencer le processus, moins d`efforts pour traiter le processus, et moins d`efforts pour vous renvoyer le résultat. Une demande de lot vous permet d`envoyer plusieurs demandes d`API en une seule fois. Cela peut vous aider à éviter les limites de taux pour les actions qui doivent être répétées plusieurs fois. Les exemples de cas où vous souhaiterez peut-être utiliser les demandes par lots incluent: Remarque: un ensemble de n requêtes regroupées en nombre compte pour votre limite d`utilisation comme n demandes, pas comme une seule demande. La demande de lot est démise dans un ensemble de requêtes avant le traitement. Par exemple, si vous fournissez un en-tête Authorization pour un appel spécifique, cet en-tête s`applique uniquement à cet appel.

© 2013 Виталия Белоусова. Все права защищены.