API UDDI - save_service
La description
L'appel d'API save_service ajoute ou met à jour un ou plusieurs éléments businessService.
Cet appel d'API renvoie un message serviceDetail contenant les résultats finaux de l'appel qui reflète les informations nouvellement enregistrées pour les éléments businessService concernés. Dans les cas où plusieurs éléments businessService sont passés dans la demande, le résultat contiendra les résultats finaux pour chaque businessService passé et ceux-ci se produiront dans le même ordre que celui trouvé dans la demande. Si la même entité est répertoriée plus d'une fois dans le message save_service, elle peut être répertoriée une fois dans le résultat pour chaque apparition dans le message save_service. Si tel est le cas, la dernière apparition dans les résultats représente l'état final enregistré.
Syntaxe de la version 2.0
<save_service generic = "2.0"
xmlns = "urn:uddi-org:api_v2" >
<authInfo/>
<businessService/> [<businessService/>.]
</save_service>
Arguments
authInfo - Cet argument obligatoire est un élément qui contient un jeton d'authentification. Les jetons d'authentification sont obtenus à l'aide de l'appel d'API get_authToken.
businessService - Un ou plusieurs éléments businessService complets peuvent être transmis. Dans le but d'effectuer des mises à jour aller-retour, ces données peuvent être obtenues à l'avance en utilisant l'appel API get_serviceDetail ou par tout autre moyen.
Erreur renvoyée
Si une erreur se produit lors du traitement de cet appel d'API, un élément dispositionReport sera renvoyé à l'appelant dans une erreur SOAP. Les informations de numéro d'erreur suivantes seront pertinentes:
E_authTokenExpired - Cela signifie que la valeur du jeton d'authentification transmise dans l'argument authInfo n'est plus valide car le jeton a expiré.
E_authTokenRequired - Cela signifie que la valeur du jeton d'authentification transmise dans l'argument authInfo est manquante ou non valide.
E_invalidKeyPassed - Cela signifie que la demande ne peut pas être satisfaite car une ou plusieurs valeurs uuid_key spécifiées ne sont pas une valeur de clé valide. Cela inclut toutes les références au tModelKey, ainsi que les références aux valeurs serviceKey ou bindingKey qui n'existent pas non plus.
E_userMismatch - Cela signifie qu'une ou plusieurs des valeurs uuid_key transmises font référence à des données qui ne sont pas contrôlées par la personne représentée par le jeton d'authentification. La clé à l'origine de l'erreur sera clairement indiquée dans le texte d'erreur.
E_invalidValue - Une valeur transmise dans un attribut keyValue n'a pas réussi la validation. Cela s'applique aux catégorisations vérifiées, aux identificateurs et aux autres listes de codes validés. Le texte d'erreur indiquera clairement la combinaison clé-valeur qui a échoué la validation.
E_requestTimeout - Cela signifie que la demande n'a pas pu être exécutée car un service validate_values nécessaire n'a pas répondu dans un délai raisonnable. Les détails identifiant le service défaillant seront inclus dans l'élément dispositionReport.
E_valueNotAllowed - Des restrictions ont été placées par le fournisseur de taxonomie sur les types d'informations qui doivent être incluses à cet emplacement dans une taxonomie spécifique. Un service validate_values choisi par le site opérateur a rejeté cette businessEntity pour au moins une catégorie spécifiée.
E_accountLimitExceeded - Cela signifie que les limites du compte utilisateur ont été dépassées.