OpenAPI Specification ドリブンな開発事例とそれを支えるツール - NTT Communications Engineers' Blog
これは NTT Communications Advent Calendar 2021 3日目の記事です。 こんにちは、イノベーションセンターの松田 (@take4mats) です。 当社の Smart Data Platform (SDPF) のサービスラインナップの多くは、お客さまがサービスご利用に必要な操作を統一的に行うための Web UI に加え、同等の Web API を提供しています。 API 仕様は Knowledge Center にてサービスごとに一般公開されているのをご存知でしょうか？ (Knowledge Center で各サービス内の APIリファレンス のページをご覧ください。例えば こちらのリンク) この一般公開されている API 仕様はサービス開発初期に作成され、開発期間にも重要な役割を果たしています。 本記事では、その中で私が携わったサービスから、 API
COTOHA API新元号対応 - Qiita
新元号は令和 本日ついに新元号が発表されましたね。５月１日からは平成が終わり、令和になります。 ということで、私たちのCOTOHA APIで早速新元号対応をいたしました。 以下が構文解析と固有表現抽出結果です。 APIの利用方法は公式ページやこちらの記事に説明がありますので、試してみてください。 parse (構文解析）結果 入力文：「新元号は令和になりました」 {'message': '', 'result': [{'chunk_info': {'chunk_func': 2, 'chunk_head': 1, 'dep': 'D', 'head': 2, 'id': 0, 'links': []}, 'tokens': [{'attributes': {}, 'features': [], 'form': '新', 'id': 0, 'kana': 'シン', 'lemma': '新'
API 設計ガイド | Cloud APIs | Google Cloud
フィードバックを送信 API 設計ガイド コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。 変更履歴 はじめに これは、ネットワーク API の一般的な設計ガイドです。2014 年以来 Google 内部で使用され、Cloud API やその他の Google API を設計するときに Google が従うガイドです。この設計ガイドは、外部のデベロッパーへの情報提供と、互いの連携作業の効率化のためにここで共有されています。 Cloud Endpoints のデベロッパーには、このガイドは、gRPC API を設計するときに特に役立つことがあり、そのような場合にはこれらの設計原則を使用することを強くおすすめします。ただし、このガイドの使用は必須ではありません。Cloud Endpoints と gRPC はガイドに従わなくても使用できます。 このガイドは、gR
プログラマブル電球milightで遊ぼう(RGBW/DW) - takashiskiのブログ
2017/01/18追記 ブリッジに新バージョンv6.0が2016/12にリリースされました。 この内容はv5.0およびRGBWとDW電球のみの話になります。 v6.0はそのうちまとめます。 ----- コミケでちょっと書いたやつのざっくり版 1. 概要 プログラマブル電球欲しい でもHue高い(電球三つとブリッジで26000+) 機能劣るけど安い奴あった(milight) Philips hue(ヒュー) スターターセット 929000259907 リテールパッケージ 出版社/メーカー: Philips(フィリップス) 発売日: 2014/01/26 メディア: Personal Computers この商品を含むブログを見る 2. milightについて RGB256段階色変更可能 以下は白→0x00から0xffまで変化->白。最初の白色がだいぶ白く見えるけど実際にはもっと赤みがかかっ
Consulを使ってみた | Pocketstudio.jp log3
Consul ( http://www.consul.io/ ) という新しいツールが4月17日(日本時間18日)に発表されました。Vagrant や Serf の作者さんが所属している Hashicorp 社としての新しいプロダクトです。 サイトによると、Consul は、’solution for service discovery and configuration’ とあり、サービス検出と設定のためのソリューションであり、具体的には、サービス（データベースやメール等々）を監視し、問題発生時にはトラフィックを迂回させるなどといった情報を、KVS を通して提供するもの、と書かれています。 また、複数のデータセンタにまたがる非常に大きなインフラ（基盤）上で、既に数ヶ月間利用されてきた実績もあるようですね。 4/19追記：背景やアーキテクチャのドキュメントは、別途本厄翻訳しました Cons
RailsでAPIをつくるときのエラー処理 - Qiita
例外を利用して実装すると便利な場合が多い この投稿では、HTTP経由でJSONを返すようなWeb APIをRailsを利用して実装するとき、エラーレスポンスを返す場合の処理をどう実装するとやりやすいのか、というニッチな話題に触れる。APIでエラーを返したいとき、即ち400以上のステータスコードと共にレスポンスを返したいような場合、どう実装するのが良いか。もしリクエストの処理中にエラーが検出された場合、それ以降の処理を行わずに直ちに中断してエラーレスポンスを返したいという場合が多いため、例外を利用して実装すると便利な場合が多い。 例外を利用しない方が良い場合もある 1つのリクエストに複数の問題が含まれている場合、先に見つけた問題だけを報告するようなエラーレスポンスを返すのか、それとも問題を抱えながらも進めるところまで処理を進めて報告可能な情報を全て含むようなエラーレスポンスを返すのか、という
RailsでAPIを作るときのエラー処理について | Yucchiy's Note
RailsでAPIを雑に書いていたんだけど, コントローラとかをどう書くとエラー処理しやすくなっていいかなーと考えていて, 個人的に考えがまとまったのでブログ書いた. ※9/1に追記書いた. 良いエラー処理について 個人的にAPIを書く上で(API書くに限らない気はするけど)どういうふうにエラー処理を行うと良いかなーと考えてみると コントローラ内では基本的に, ある関数の処理が失敗して, 次の処理が行えない場合はすべて例外を投げる 例外は各々のコントローラ内で例外のキャッチは行わず, すべてApplicationControllerなど, 親コントローラ内の1メソッドで完結させる かなーと思う. APIのエラー処理は, Envelopeにステータスコードとエラーメッセージを書いて, APIのフォーマットを統一するほうがクライアントが作りやすそうだし, またこのように処理することで, エラー
APIデザインの極意 - ✘╹◡╹✘
APIデザインの極意 Java/NetBeansアーキテクト探究ノート 作者: Jaroslav Tulach,柴田芳樹出版社/メーカー: インプレスジャパン発売日: 2014/05/23メディア: 単行本（ソフトカバー）この商品を含むブログ (4件) を見る API設計は難しい "良い"APIを設計するのは難しく、APIの良し悪しを定量的に観測することは難しいとされている。後方互換性や拡張性、不具合の発生率などで曖昧に推し量ることはできるが、これは良い、これは悪い、とはっきり決め付けることは出来ない。そもそもAPIから「これ」と呼べるある側面を切り出すことも難しいと言える。また、APIの設計技法を学べる機会は多くないとしている。物事を感覚として認識することはできても、それを表現し他人に伝え信じてもらう方法を持たない場合が存在する。 API設計を芸術的取り組みにしてはいけない API設計の
総務省｜報道資料｜統計データにおけるAPI機能の試行運用開始
総務省は、統計データの高度利用環境の構築のため、平成25年6月10日（月）午前10時から、統計データにおけるAPI機能の導入による試行運用を開始します。これは、オープンデータ推進のトップランナーとして政府の取組を先導するものです。 総務省統計局は、平成25年5月28日付け報道資料（参考1）のとおり、統計におけるオープンデータの高度化を進めることとしており、今般、このうちAPI機能の導入について、独立行政法人統計センターが運用する「次世代統計利用システム」上で、6月10日午前10時から試行運用を開始することになりました。 API機能の導入により、例えば、(1)利用者の情報システムに政府統計のポータルサイト（e-Stat）のデータを自動的に反映、(2)ユーザー保有やインターネット上のデータ等と連動させた高度な統計データ分析などが可能となります。これにより、ビジネス活性化や新規事業の開発促進、行
Twitter API Documentation
<g> <g> <defs> <rect id="SVGID_1_" x="-468" y="-1360" width="1440" height="3027" /> </defs> <clippath id="SVGID_2_"> <use xlink:href="#SVGID_1_" style="overflow:visible;" /> </clippath> </g> </g> <rect x="-468" y="-1360" class="st0" width="1440" height="3027" style="fill:rgb(0,0,0,0);stroke-width:3;stroke:rgb(0,0,0)" /> <path d="M13.4,12l5.8-5.8c0.4-0.4,0.4-1,0-1.4c-0.4-0.4-1-0.4-1.4,0L12,10.6L6.2
RubyでTwitter Streaming APIを使ってみる - プログラマでありたい
何かTwitterを使ったサービスを作ってみたくて、時間が空いている時にTwitterの仕様を眺めています。 TwitterはAPIが充実していて、非常に開発者フレンドリーです。 ただAPIの使用については回数制限などある程度の制約があるので、目的に沿って使う必要があります。 主なAPIは３種類あって、それぞれの特徴と制約です。 REST API Methods ユーザーが行う操作に関するAPIです。 一般的なTwitterクライアントソフトは、これを使って作られています。 IPとアカウントベースでの制限で、１時間に150回まで 申請をして許可が取れれば20,000回まで増やせるようです。 Search API Methods 名前の通り検索系のAPIです。 IPアカウントベースの制限。REST APIに比べて、極めて多い回数を使えるようです。 これも申請によって回数が増やせるようです。
Google+ API 使い方
Google+のAPIが遂に公開されました！最初はパブリックデータを扱うAPIのみですが、やがてfacebookのGraph API同様、認証・許可を得て非公開の情報も取得できるようになるようです。 Google公式アナウンス：Getting Started on the Google+ API WebサービスはRESTfulで提供されておりHTTPリクエストを投げるだけでOKです。 2011年9月16日現在、利用できるメソッドはユーザー情報取得（People.get)と一般公開されているポストデータを取得する（activities.list）の2つのメソッドだけで読み込みのみです。従って、APIを通じてポストを投稿することが出来ません。 また開発者向けに5つの言語(Java, GWT, Python, Ruby, PHP, Obj-C,.NET)でライブラリーが提供されています。 Goo
1
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
東京メトロ、列車の在線位置など全線オープンデータ化、車両の所属会社も 
Twitter API最新事情 - API Meetup Tokyo #1 #apijp
大規模分散システム ”Amazon Web Services” の使い方
GitHub - googleapis/google-api-ruby-client