|
|
Les deux architectures primaires pour APIs sont REPOS et SAVON. En créant votre api, vous avez vraiment trois options : REPOS, SAVON, ou tous les deux. Il est connu pour être facile et rapide se développer REPOS APIs pour, mais la demande entière est introduite l'espace libre indépendamment du type de chiffrage utilisé. Le SAVON APIs sont plus complexe, exigeant plus d'effort de produire de la réponse et de manipuler la demande, mais tiennent compte d'une plus grande flexibilité en ajoutant l'appui de namespace. Fournir APIs des deux types peut ressembler à d'une option attrayante, mais maintenir dans l'esprit qu'il doublera votre entretien, soutien, et temps de documentation de la vie de l'api.
Les deux méthodes d'api déjà ont été présentées longuement ; cette section se concentre sur des différences pour maintenir dans l'esprit en développant un api.
Quand recevant une demande de REPOS, l'information entrera par l'intermédiaire de OBTENEZ. En tant que tels, toute l'information devra URL-ÊTRE codée pendant la transmission ; vous voudrez probablement la décoder avant de la soumettre à une transformation plus ultérieure (l'exception étant des usernames et des mots de passe, qui sont généralement réels traité). Différents types de demande devraient être adressés à différents points finaux (URLs) ; si vous voulez employer un manuscrit simple pour manipuler toutes les demandes, vous pouvez l'un ou l'autre présent il aux réalisateurs du fait façon (toutes les demandes vont à un point final simple), ou configurez votre web server pour tracer beaucoup de points finaux à un manuscrit simple. Je suggérerais généralement le dernier ; il est en ligne avec les spécifications et il vous permet de rendre des changements plus tard sans affecter l'utilisation externe de réalisateurs d'interfaces.
Considérez permettre à des réalisateurs d'employer une interface d'enchaînement pour faire des demandes contre l'api. Ceci peut être utile grand en essayant de diagnostiquer un problème ; les réalisateurs pourront déterminer rapidement si le problème est la demande ou leur code. Plus que vous pouvez fournir aux réalisateurs en termes de diagnostic outils, plus facile il sera de se développer pour votre emplacement.
Quand la demande de SAVON entre, il devrait d'abord vérifier pour s'assurer qu'il se conforme au format indiqué par votre document de WSDL. Si vous utilisez un outil tel que NuSOAP, ceci est fait pour vous. En fait, la plupart d'utilisation d'APIs de SAVON un certain cadre qui prend soin de beaucoup du travail de grognement en manipulant les demandes. Utilisation d'APIs de SAVON que un point final simple pour tout demande (en règle générale, quelques grandes fonctions disparates séparées d'APIs sur différents points finaux), et en conséquence vous probablement l'un ou l'autre aurez un grand manuscrit à ce point, ou un bon nombre d'appels de require() exécutés selon l'appel particulier.
Considérez permettre à des réalisateurs d'employer une interface d'enchaînement où ils peuvent coller les documents entiers de demande sur une forme, et courez-les contre votre serveur. Parler d'une expérience directe, ayant quelque chose comme ce disponible est utile grand aux réalisateurs en essayant de diagnostiquer un problème. Fournir des manuscrits ou des fonctions sur votre emplacement pour permettre à des lotisseurs de créer des demandes manuellement sera également d'aide aux réalisateurs n'employant pas un cadre de SAVON.
Online: 851 users browsing the articles directory
|
|