僕が考えた最強のAPIドキュメント生成 - 銀の人のメモ帳
2023 追記 2023 年現在では、以下の文章では採用を見送っている OpenAPI を使えば OK という雰囲気です。 Web APIの設計 作者:Arnaud Lauret翔泳社Amazon TL; DR ドキュメント生成にはkevinrenskers/raml2htmlを使った ドキュメントはRAML - RESTful API modeling languageで書いた RAMLにはJSON SchemaとJSONを記載できる APIで返ってくるJSONはRailsアプリのrequest specでJSON Schemaを使ってテストした JSON Schemaはr7kamura/json_worldで生成した ドキュメントに載せる例示のJSONもJSON Schemaからgin0606/screijiを使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
HerokuのAPIデザイン
Herokuが自ら実践しているAPIデザインガイドをGithubに公開した． “HTTP API Design Guide” このガイドは些細なデザイン上の議論を避けて，ビジネスロジックに集中すること目的としている．Heroku特有なものではなく，一般にも十分適用できる知見となっている． 最近は，モバイル向けにAPIをつくることも多いため，勉強もかねて抄訳した．なお内容は，HTTP+JSONのAPIについて基本的な知識があることが前提となっている． 適切なステータスコードを返す それぞれのレスポンスは適切なHTTPステータスコード返すこと．例えば，“成功"を示すステータスコードは以下に従う． 200: GETやDELETE，PATCHリクエストが成功し，同時に処理が完了した場合 201: POSTリクエストが成功し，同時に処理が完了した場合 202: POSTやDELETE，PATCHリク
YappoLogs: 2014年に向けた JSON API の実装の方向性と X-JSON-Status 改め X-API-Status header のご提案
2014年に向けた JSON API の実装の方向性と X-JSON-Status 改め X-API-Status header のご提案 追記 2014/11/20 14:00:00 わりと JSON やら XML やら各種フォーマットで API を運用している環境がある場合に JSON API の時だけ X-JSON-Status にすると XML とかの時と整合性取れないし、 X-XML-Status みたいのを量産するのは困る的なレビューを頂いたので X-JSON-Status をやめて X-API-Status にしました。 へたに JSON に限定するから REST とか JSON-RPC とかいわれるんや！ X-API-Status にしたら全部解決したし MessagePack な API でも使い回せるって songmu さん言ってた！ XML とかからどうやって引っこ抜
日本の全エンジニアに捧ぐ！現在公開されているAPI一覧【2013年版】 | Find Job ! Startup
2013年のいま、API界隈が熱い！ 今年に入り、官公庁の統計データやNHKの番組情報など、今までなかなか利用できなかったデータがAPIとして扱えるようになってきました。このエントリでは現在公開されているAPIを一覧でまとめます。いま使えるAPIはこれだけ読めば大丈夫。2013年の最新マッシュアップ事情をあますとこなく網羅します！ HOT! API 総務省 次世代統計利用システム（国勢調査、人口推計、就業構造、企業統計、物価統計 etc.） NHK番組表（※未公開） 行政・自治体・公共サービス 郵便番号 郵便番号検索API（郵便番号 → 住所） 郵便専門ネット（郵便番号 → 住所、郵便番号の簡易存在チェック） ぽすたん（郵便番号 → 住所、住所 → 郵便番号） IW3 PROJECT（郵便番号 → 住所、住所 → 郵便番号） 宇宙 Google+ JAXA PR（※現在一部の学生に限定公開
API | J-SHIS
指定した250mメッシュの再現期間10万年相当の震度等、J-SHIS地点情報で出力可能な長期間平均ハザード属性を提供します。
Login with Amazon | Secure Login Service | Amazon Developer Portal
Securely connect with millions of Amazon customers and personalize their experience Let customers log in to your site or app in just a few clicks using their Amazon accounts. Leverage a brand customers trust while getting data like name, email address, and zip code to build a more personalized experience.
iPhone向けpixiv API by moyashi - Pastie
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127
GifBoomのJSON API · GitHub
GifBoomのWeb APIを調べたのでメモ。公開されてるものではないので使用は自己責任で。とりあえず便利そうなやつだけ。 レスポンスはすべてJSON形式で返ってくる。だいたいのAPIは認証なしで使える模様。 あるユーザーの投稿したGIF一覧を取得したい場合、まず/v1/users/searchでusernameからuser_idをとってきて、そのuser_idを使って/v1/feed/user_timelineにリクエストを投げればいい。 GET /v1/users/search ユーザーを検索する。usernameからuser_idをとってくるのに使える。 パラメータ q - 検索するusername page (option) 用例 { "paging" : { "previous" : 1, "next" : -1, "current" : 1, "pagesize" : 100
Web API 設計のベストプラクティス集 "Web API Design - Crafting Interfaces that Developers Love" - フリーフォーム フリークアウト
移転しました http://please-sleep.cou929.nu/20130121.html
Instagramから写真を取ってきて表示できるjQueryプラグイン「jQuery Spectragram」:phpspot開発日誌
jQuery Spectragram Instagramから写真を取ってきて表示できるjQueryプラグイン「jQuery Spectragram」。 APIをJS経由で叩いて、タグ、ポピュラー、指定ユーザの写真をフェッチしてページに表示することが出来るようになります。 APIを使うためDevTokenとClientIDが必要になります 自分の撮った写真をサイト上にお手軽に表示したい場合に使えそうです 関連エントリ 画像をアップしてInstagram風エフェクト等様々な編集も可能なBootstrapベースのアプロダ「Filepicker.io」 PHPでInstagram風に画像フィルタをかけられるクラスライブラリ
Zend Framework: Documentation
The YouTube Data API offers read and write access to YouTube's content. Users can perform unauthenticated requests to Google Data feeds to retrieve feeds of popular videos, comments, public information about YouTube user profiles, user playlists, favorites, subscriptions and so on. For more information on the YouTube Data API, please refer to the official PHP Developer's Guide on code.google.c
HTTP
Azure AI Translator documentation Azure AI Translator is a cloud-based machine translation service you can use to translate text and documents with a simple REST API call. The service uses modern neural machine translation technology. The Custom Translator interface allows you to use your translation memory to create customized neural translation systems. The customized translation system can be u
Review: Vimeo API Update Provides Robust Access to Service's Ecosystem | ProgrammableWeb
Unleash the power of Salesforce Customer 360 through integration Read more
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
http://data.brace.io/
WinMX Unlimited - WinMX Chat Room List
Web Capture with GrabzIt - Turn Websites into PDF, Images or Data
IDEA * IDEA
Kong API Gateway and Service Connectivity Platform
ユースケースとコード スニペット | YouTube Data API | Google for Developers
Location Intelligence Platform for Spatial Analytics | CARTO
