ZEPETO.Multiplay.HttpService
12 min
type description httpcontenttype /#httpcontenttype énumération de constantes spécifiant le content type http httpbodytype /#httpbodytype alias de type pour le contenu du corps http, qui peut être du texte brut ou un objet clé valeur httpheader /#httpheader alias de type pour les en têtes http, représentant un objet clé valeur httperrortype /#httperrortype énumération de constantes spécifiant les raisons d'échec des requêtes http httperror /#httperror représente une erreur survenue lors d'une requête http httpresponse /#httpresponse représente une réponse http httpservice /#httpservice httpservice fournit une api permettant d'établir des connexions http avec des services web externes et d'effectuer des requêtes veillez à utiliser le protocole https ; le protocole http n'est pris en charge que dans l'environnement de développement les requêtes sont limitées aux ports 80 et 443 la taille maximale des corps de requête et de réponse est de 16 ko limitez le nombre de requêtes à moins de 500 par minute afin d'éviter d'éventuelles restrictions du service world dues à un nombre excessif de requêtes les requêtes échouent si les services web externes ne répondent pas dans un délai de 5 secondes assurez vous que le content type des en têtes de réponse correspond aux valeurs définies dans l'énumération httpcontenttype afin d'éviter les échecs de requête les requêtes web pouvant échouer pour diverses raisons, il est recommandé d'écrire du code défensif httpcontenttype enum énumération de constantes spécifiant le content type http nom valeur description applicationjson "application/json" représente le type de contenu application/json applicationxml "application/xml" représente le type de contenu application/xml applicationurlencoded "application/x www form urlencoded" représente le type de contenu application/x www form urlencoded textplain "text/plain" représente le type de contenu text/plain textxml "text/xml" représente le type de contenu text/xml httpbodytype delegate alias de type pour le contenu du corps http, qui peut être du texte brut ou un objet clé valeur string | { \[key string] any; } httpheader delegate alias de type pour les en têtes http, représentant un objet clé valeur { \[key string] string | number; } httperrortype enum énumération de constantes spécifiant les raisons d'échec des requêtes http nom valeur description err access denied "err access denied" erreur accès refusé err length required "err length required" erreur longueur requise httperror interface · extends error représente une erreur survenue lors d'une requête http propriétés nom type description message string message d'erreur code string code d'erreur défini comme une valeur de l'énumération httperrortype httpresponse interface représente une réponse http propriétés nom type description statuscode number code d'état de la réponse en général, 200 indique une requête réussie statustext string message d'état correspondant au code d'état en général, « ok » indique une requête réussie response string corps de la réponse http, dont le format peut varier selon le content type de la réponse il est recommandé d'utiliser un analyseur adapté au content type reçu httpservice interface httpservice fournit une api permettant d'établir des connexions http avec des services web externes et d'effectuer des requêtes veillez à utiliser le protocole https ; le protocole http n'est pris en charge que dans l'environnement de développement les requêtes sont limitées aux ports 80 et 443 la taille maximale des corps de requête et de réponse est de 16 ko limitez le nombre de requêtes à moins de 500 par minute afin d'éviter d'éventuelles restrictions du service world dues à un nombre excessif de requêtes les requêtes échouent si les services web externes ne répondent pas dans un délai de 5 secondes assurez vous que le content type des en têtes de réponse correspond aux valeurs définies dans l'énumération httpcontenttype afin d'éviter les échecs de requête les requêtes web pouvant échouer pour diverses raisons, il est recommandé d'écrire du code défensif méthodes getasync getasync(url string, headers? httpheader) → promise\<httpresponse> exécute une requête http get de manière asynchrone lève httperror paramètre type description url string adresse web à laquelle envoyer la requête headers (facultatif) httpheader /#httpheader en têtes de la requête http (facultatif) renvoie promise\<httpresponse> — promise résolue avec l'objet httpresponse à la fin de l'opération postasync postasync(url string, body httpbodytype, headers? httpheader) → promise\<httpresponse> exécute des requêtes http post de manière asynchrone lève httperror paramètre type description url string adresse web à laquelle envoyer la requête body httpbodytype /#httpbodytype contenu du corps de la requête headers (facultatif) httpheader /#httpheader en têtes de la requête http (facultatif) renvoie promise\<httpresponse> — promise résolue avec l'objet httpresponse à la fin de l'opération postasync postasync(url string, body httpbodytype, httpcontenttype httpcontenttype, headers? httpheader) → promise\<httpresponse> exécute des requêtes http post de manière asynchrone lève httperror avec cette signature, si vous ajoutez « content type » aux en têtes, il sera remplacé par la valeur spécifiée dans httpcontenttype paramètre type description url string adresse web à laquelle envoyer la requête body httpbodytype /#httpbodytype contenu du corps de la requête httpcontenttype httpcontenttype /#httpcontenttype spécifie l'en tête content type de la requête headers (facultatif) httpheader /#httpheader en têtes de la requête http (facultatif) renvoie promise\<httpresponse> — promise résolue avec l'objet httpresponse à la fin de l'opération