Quelle est la norme d'or pour le site web de l'Api? Twitter, Flickr, Facebook, etc
Semble comme il y a deux catégories d'Api pour les sites web d'aujourd'hui.
-
Des APIs qui permettent le fonctionnement du site pour être étendu comme Facebook, Myspace, etc. Ces Api semblent être très diverses.
-
Api permettant l'interaction avec le site existant comme Twitter, Flickr, etc. Ces tous prétendent être en RESTE sur la base, mais sont en réalité simplement "données via HTTP".
Si vous avez été la création d'un site web qui a permis à la fois fonctionnelle extension et à l'extérieur de l'interaction, ce que l'Api vous l'utiliser comme un modèle de référence?
- streisand effet dans 3... 2... 1...
- Streisand effet est principalement en ligne phénomène dans lequel une tentative de censurer ou de supprimer un élément d'information qui a pour conséquence involontaire de provoquer l'information à être diffusé de manière et à une plus grande mesure que se serait produite si pas de censure avait été tenté..." Désolé, je n'ai pas l'obtenir?
- Une meilleure question serait "Quelles sont les caractéristiques de la bonne Api Web?". Je pense que c'est ce que vous essayez d'obtenir au. Ou c'est ce que vous devez essayer d'obtenir au. Ma tentative de réponse, ci-dessous.
- eh, assez proche. Je parlais de Jeff de poster cette question sur Twitter, provoquant un afflux de upvotes à lui. Ce n'est pas exactement l'Effet Streisand, mais c'est la même jist
- Somerville, avec vous! Sans doute plus la Katie Price effet... :o)
Vous devez vous connecter pour publier un commentaire.
Nous sommes en train de faire des recherches dans ce domaine nous-mêmes. Pas beaucoup en termes de "gold standard" pour le site web de l'API de références.
Les plus courantes de site web Api référencés sont:
Une autre liste ici:
http://www.pingable.org/the-top-15-web-apis-for-your-site/
Quelqu'un recommandé le livre Les Services Web Restful comme une bonne référence sur ce.
(sentez-vous libre pour modifier la liste ci-dessus pour ajouter d'autres personnalités sites web avec des Api)
Comment Concevoir Une Bonne API et Pourquoi c'est important, un 60 minutes de Google de parler de technologie par Joshua Bloch, est pertinente.
Ayant travaillé avec quelques-uns, je vais aller droit vers le bas pour
Facebook
Myspace
Photobucket (disclaimer: j'ai écrit le côté serveur de la photobucket api)
Twitter
Caractéristiques idéales
Donc, cela étant dit... quelque chose entre Facebook et Twitter. Bien sûr, je suis partie à certaines des choses que nous avons sur Photobucket, mais je déteste aussi certaines.
Il me semble que la documentation de l'API est tout aussi (sinon plus) important que la conception actuelle de l'API.
Bien écrit, simple documentation sera pour tout les défauts de conception. C'est ce que j'ai appris après avoir regardé les différents liens déjà affichés. Plus Précisément, La Dernière.fm, la documentation semble très bonne: facile à naviguer, et facile à comprendre.
Dernier.fm api continue d'être l'un des plus bien maintenu api sur le net. Il a aussi été autour de plus de plus, parce que ça a commencé comme cela.
http://www.last.fm/api
Concernant Jeff liste des grands Api: je suis assez sûr que commune ne pas dire "Gold Standard".
Pas besoin de suivre un manuel liste de la généralisation de l'API. Pour obtenir une liste check out http://www.programmableweb.com/apis/directory/1?sort=mashups .
Comme je suis RESTE aussi lâche standard, je dirais qu'une API est "d'Or" quand il sens et est intuitive.
... tous font le plus de sens pour moi et bien pensé (comme Brian l'a déjà souligné).
Dans mon travail quotidien, je travaille également beaucoup avec OpenSocial, où les Uri sensation très naturelle, mais aussi d'étendre le RESTE standard, à sa manière.
Si vous l'aimez stricte et de sécurité, utilisez du SAVON.
Je voudrais vérifier OpenSocial, un mouvement visant à créer une API Standard pour le réseau social sices. Ils utilisent de REPOS et ont un "utilisateur" ou " approche centrée sur l'. Mais c'est très bien documenté approche qui pourrait aider, même pour un site qui n'est pas totalement Sociaux de base. Si vous êtes à la recherche pour certains de code interne implémentations de regarder Drupals un système d'accroche et de WordPress.
http://code.google.com/apis/opensocial/
Je pense que la meilleure façon de répondre est de lister les caractéristiques de bonne Api web au lieu de citer des exemples. Si vous aimez Twitter/Facebook/etc Api, quel est l'aspect de ces Api trouvez-vous jolie?
Je vais prendre un premier jet:
Veuillez ajouter d'autres commentaires.
Je n'ai pas d'expérience avec les autres, mais même si elle a évolué au fil des ans, le Facebook de l'API est toujours terrible. Il n'est pas près d'être un "gold standard". Plutôt, c'est quelque chose que les gens luttent à travers et grincent les dents, car une fois qu'ils obtiennent finalement à droite, il est possible d'ajouter beaucoup de valeur.
De certaines Api qui sont notamment la bonne:
Il dépendra de ce qui est votre public cible. Si il est .net boutiques ensuite le savon est vraisemblablement bien d'autres sages se concentrer sur le RESTE, car il est beaucoup moins bar de l'entrée.
À partir de là regarder site web Api qui ciblent les mêmes personnes que vous désirez. De cette façon, votre api seront familiers.
Force (précédemment connu en tant que SalesForce) API: http://www.salesforce.com/us/developer/docs/api/index.htm
AtomPub est l'étalon-or, car il a été conçu par certains des esprits les plus brillants sur l'internet. Vous ne pouvez pas aller trop loin de la vérité à l'aide de l'iit comme base. C'est ce que google et msft n'.
Eu une question similaire à ce qui n'a pas eu beaucoup d'action, mais pensé qu'il serait bon de lier à elle.
Ce que le web Api auriez-vous le plus à répliquer ou sont les plus populaires?
Si je devais concevoir une api web aujourd'hui pour un site web existant, en supposant que le site web a été bien conçu avec respect à sa bonne utilisation de HTTP, je utiliser le site web comme les lignes directrices de conception.
Prendre Débordement de Pile par exemple, il a le ensemble de l'espace d'URI déjà tracé. Il dispose d'un ensemble complet d'interconnexions entre les différentes représentations. Les utilisateurs du site sont déjà familiers avec la structure du site et, par conséquent, l'API structure serait déjà familier.
La seule partie qui doit changer, c'est le contenu de la représentation, pour éliminer tous les inutiles de balisage. Il serait nécessaire d'ajouter un supplément de quelques basées sur des modèles de liens pour permettre les recherches qui sont actuellement uniquement accessible via javascript. Par exemple, une recherche pour un utilisateur n'est pas facilement détectable via la navigation parce qu'actuellement, le lien est construit via javascript.
Vraiment difficile décision est ce que les médias-type à utiliser. Vous pouvez utiliser bare bones html avec RDFa style de métadonnées de balisage, ou aller sauvages et de l'utilisation de la nouvelle Microdonnées format Html5. Ou, vous pourriez revenir un support personnalisé de type basés sur xml ou Json. Quelque chose comme application/vnd.stackoverflow.question+xml, etc. Le support personnalisé de type rend la gestion des versions vraiment facile, mais c'est de moins en moins accessible pour les clients qui n'ont pas été conçus pour accéder à StackOverflow directement. Les types personnalisés pourrait être utilisé en combinaison avec de l'Atom qui sont pour la plupart déjà là, dans StackOverflow,
De la conception d'une api web est vraiment pas différent de la conception d'un site web, autre que le fait que vous êtes offrant un contenu qui sera consommée par un programme qui n'est pas un navigateur web.
Ce que vous ne voulez pas faire est de créer un Http base de données de la couche d'accès. C'est comme le fait de montrer votre sous-vêtements dans le monde. Le site web existant est optimisé pour tous les scénarios d'utilisation courants, de nombreuses api des modèles d'accès vont être similaires, afin de réutiliser les "vues" qui ont déjà été créés. Il peut être nécessaire d'ajouter un supplément de quelques liens ici et là, pour le rendre un peu plus rapide pour les programmes pour obtenir les données qu'ils veulent, mais ceux-ci peuvent être ajoutés au fur et à mesure que le besoin s'en fait sentir.
Bien écrit, les sites web sont déjà très efficaces Api pour les clients de navigateur web, il est vraiment pas nécessaire de revenir à la planche à dessin à l'appui de tout autre type de client. L'API de la structure n'a pas besoin de changer, tout le contenu proposé.