Zalando RESTful API と イベントスキーマのガイドライン
License: CC-BY-SA 3.0 © Zalando SE 2020 & CC-BY-SA 3.0 © kawasima 2020 Zalandoのソフトウェアアーキテクチャは、疎結合なマイクロサービスを中心としており、 それらはJSONペイロードをもつRESTful API群によって、機能が提供されています。 小さなエンジニアのチームは、自分たちでAWSアカウントにこれらのマイクロサービスを デプロイしたり運用したりしています。 私たちのAPIは、その多くが私たちのシステムが何をするのかを完全に表現しており、 それゆえに貴重なビジネス資産となっています。 Zalandoがとあるオンラインショップから価値あるファッションプラットフォームへと変貌を とげるために、私たちは新しいオープンプラットフォーム戦略の展開をはじめました。 なので、高品質で長持ちするAPIの設計は、私たちにとっ
僕が考えた最強の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を使って生成した 上記の方法だとリクエストパラメタとドキュメントの整合性を担保
Cloud Vision APIの凄さを伝えるべくRasPi botとビデオを作った話
（この記事はGoogle Cloud Platform Advent Calendar 2015の12月3日分の記事です） Cloud Vision APIと私 Googleに入ってからまもなく5年、Google Cloud Platformのデベロッパーアドボケイト（エバンジェリストみたいな役割）の仕事に就いてから1年が経ちました。仕事の半分はアジア地域向けの開発者コミュニティ支援で、残り半分はGCPの新製品ローンチの支援をグローバル向けに行っています。 特にここ半年は、TensorFlowをはじめ、GCPの機械学習系プロダクトのローンチ支援にフォーカスしています。TensorFlowはその序章で、公開前からAlphaカスタマー向けのスライドを作ったり説明やデモしたりしていました。 そうしたGCPの新しい機械学習系サービスのひとつが、Cloud Vision APIです。これはGoogl
Vision AI: Image & Visual AI Tools
Document understanding made easy with generative AI—summarize large documents with a Google-recommended, pre-built solution. Access advanced vision models via APIs to automate vision tasks, streamline analysis, and unlock actionable insights. Or build custom apps with no-code model training and low cost in a managed environment. New customers get up to $300 in free credits to try Vision AI and oth
Apiary - r7kamura per second
API(とそれに携わる開発者)の規模が拡大してくると、ドキュメントの整備や、仕様と実装の一貫性の維持、 クライアントとの知識の共有など、考慮すべき問題が沢山出てくる。 これらの問題に対する現実的な解決策を探るため、 ApiaryというAPI開発支援用のサービスを簡単に俯瞰することにした。 ここでは紹介しないが、他に RAML、 JSON Schema、 Swagger、 WADL、 Autodoc などが関連するものとして挙げられる。 Apiary http://apiary.io/ Apiaryは、API Blueprintと呼ばれる言語でAPIのインターフェース仕様書を記述する、という開発方法を提唱している。 API BlueprintはMarkdownを拡張した言語で、特殊な記述を用いて幾つかのメタ情報を付与出来る形になっている。 Markdownを採用することで人間にとって読み書き
Managing your personal access tokens - GitHub Docs
About personal access tokens Personal access tokens are an alternative to using passwords for authentication to GitHub when using the GitHub API or the command line. Personal access tokens are intended to access GitHub resources on behalf of yourself. To access resources on behalf of an organization, or for long-lived integrations, you should use a GitHub App. For more information, see "About crea
Githubの各種イベント通知をPubSubHubbubで受け取るの巻 - unknownplace.org
tl;dr - 通常のHookではなくPubSubHubbubのほうのHookを使えばGithubのすべてのイベントをひとつのWebHookで受け取ることができる。 Github の WebHook ではレポジトリの更新しか受け取れず、issue とかも受け取れたら便利なのになーと思いつつ API ドキュメントを見てみると Hook を API から登録したりすることができるようになっていた。 だがこれは所詮は Web から登録できる Hook をいじるもので、このリストにあるものしか登録できない。 また、それぞれの Hook について登録できるイベントはリストで定義されている物に制限されているようで、たとえば WebHook だと push イベントしか設定することはできないみたい。（API 経由でも設定できなかった） 一方、それとは別に用意されている PubSubHubbub の Ho
livedoor Techブログ : 鉄道情報APIをロケタッチでリリースしましたのお知らせ
にどめまして！前回の住所正規化 APIが好評なようで花粉症が吹き飛んでいた Yappo です。 さて、今回は表題の通り鉄道情報 APIをリリースしたのお知らせです。 鉄道情報 API ってなに? 日本国内の鉄道路線や鉄道駅を検索する事が出来る API です。 例えば、路線一覧や山手線の駅一覧を JSON 形式で簡単に取得出来ます。 基本的にはデータソースとして駅データ様のデータを利用しているため、基本的には駅データの仕様に準拠していますが、ロケタッチ独自の情報を付与したデータを返しています。 使い方 使い方は簡単で、前回の住所正規化 API のように単純に GET リクエストを飛ばすだけで良いです。 例えば山手線の全駅リストを Perl で書きたい場合には以下のように書きます。 use strict; use warnings; use 5.016; use JSON; use LWP::
Facebookのアクセストークンの有効期限について調べてみた - Shaw's Home Page（本館）
2012年8月4日補足 今もこの記事にたどり着く方が結構多いようですが、内容はすでにちょっと古いです。 おそらく下記URLの内容のほうが、大いに参考になるかと思います。 offline_accessパーミッション削除に対応する 久々にFacebookのAPIネタです。お題は、とあるFacebookページの最新Feedをcron使って定期的に取得したい、というケースでどうすればいいのか、です。ちょっとはまったのでメモを残しておく。 まず最初に考えたのは、有効期限のない固定化されたアクセストークンを取得して、そのトークンを使ってgraph APIにリクエストを投げるという方法。普通にアクセストークンを取得すると1時間〜2時間という有効期限がセットされてしまうけど、offline_access権限をつけて取得したアクセストークンは固定化されるはずなので、あとはGraph APIエクスプローラにて
livedoor Techブログ : 住所正規化APIをロケタッチでリリースしたよ！１
LINE が PC から使えるようになって、自社サービスなのに wktk しながらハックしてた大沢Yappo和宏です。こんにちわ。初めましての人は初めましてね。 今回は、先日ロケタッチの API に、住所正規化 APIを追加したので簡単な紹介をします。 ロケタッチ API って何？ ロケタッチ API は、ロケタッチのユーザーデータ、スポットデータ、チェックインデータ等にアクセスできる API です。 OAuth2 で実装されているので、どのような言語からも利用しやすくブラウザだけで完結するような JavaScript アプリケーション等にも気軽に導入する事が出来ます。 Perl の世界だと Amon2 という Web Application Framework の認証プラグインとしてAmon2::Auth::Site::Loctouchが CPAN にあるので、これを使うと簡単にロケタッ
Google MapsのAPI有料化へ
無料で使うには性能が良くなり過ぎたのだ。 Google提供のサービスの最高にして最大の魅力は｢無料｣だということ。こんなに素晴らしいものを無料で提供してくれるなんてありがたいことです。が、その無料伝説にも限界がありました。 Googleの提供する大きなサービスの1つであるGoogle Mapsが来年2012年1月1日より一部有料となります。有料化されるのはGoogle APIで、日に2万5000回以上APIにアクセスする場合は課金されるようになります。価格はまだ詳しく発表されていませんが、噂では2万5000回を超える場合は1000回につき4ドル（約312円）程度になるのではないかとのこと。また、1日に2万5000回を超えてアクセスをするのはユーザー全体のほんの0.35％くらいだということなので、ほとんどの人はまだまだこの素晴らしい地図サービスを無料で使用し続けることができますね。 [BBC
Share Button Documentation
Overview This documentation is for developers who want to control how their website content is displayed in Tumblr posts created by a share button widget installed on their page. To get share buttons for your site, make one with our share button generator. Basic button On pages that include our share button JavaScript (below), the share button is simply an anchor tag with the class tumblr-share-bu
Ring
Ringとは、リクルートグループ会社従業員を対象にした新規事業提案制度です。 『ゼクシィ』『R25』『スタディサプリ』など数多くの事業を生み出してきた新規事業制度は、 1982年に「RING」としてスタートし、1990年「New RING」と改定、そして2018年「Ring」にリニューアルしました。 リクルートグループの従業員は誰でも自由に参加することができ、 テーマはリクルートの既存領域に限らず、ありとあらゆる領域が対象です。 リクルートにとって、Ringとは「新しい価値の創造」というグループ経営理念を体現する場であり、 従業員が自分の意思で新規事業を提案・実現できる機会です。 Ringフロー その後の事業開発手法 Ringを通過した案件は、事業化を検討する権利を得て、事業開発を行います。 さまざまな事業開発の手法がありますが、例えば既存領域での事業開発の場合は、 担当事業会社内で予算や
APIドキュメント | Last.fm
# Last.fm Music Discovery API The Last.fm API allows anyone to build their own programs using Last.fm data. Find out more about how you can plug directly into our vast database or browse the list of methods on the left. # Getting started Our API is available to anyone. Here's what you need to get going: Get an API account Read the Documentation Join the Support Forums Commercial or Research Usage
Linux上で動くSkype用のbotを作る方法 - muddy brown thang
はじめに 以前、知人のやっているBeProudという会社を手伝ったのですが、BeProudでは、エンジニアの主要なコミュニケーション手段としてSkypeが使われていました。当時、趣味でたまたまSkypeのAPIについて調べていたので、悪戯っ気を出して、開発環境に即席でSkype APIを使ったbotを設置してみたところ、思いのほか好評を博し、いまやインフラと言っても過言ではない存在 *1 *2と化したようです。 まあそんな状況を眺めつつ、自宅のサーバにSkype botを設置して、お気に入りのSkypeチャットにもbotを加えてみたところ、これも結構好評だったので、興味ありそうな人向けに作成方法をまとめることにします。 Skype Public API Skype Public APIとは、Skypeを外部からコントロールするためのインターフェイスです。 Skype Public APIを
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
https://groups.google.com/forum/#!msg/google-maps-api-japan/IdLB1BtMPBM/zZFusfZp0hcJ
Google Maps APIの有料化、「上位0.35％のサイトのみが影響」と説明 
Google Maps API有料化の詳細発表、該当ユーザーは2012年初めに強制課金開始 
Hatena Developer Center
Charming Python: Functional programming in Python, Part 3
