【新機能】Amazon API GatewayがACM (AWS Certificate Manager)に対応。簡単に独自ドメインAPIがSSL化。 | DevelopersIO
【新機能】Amazon API GatewayがACM (AWS Certificate Manager)に対応。簡単に独自ドメインAPIがSSL化。 こんにちは、せーのです。今日はAPI Gatewayの最新アップデートをご紹介します。 とかく証明書は大変 Web系の方はおわかりかと思いますが、サイトURLをSSLで見るには証明書が必要で、一般的にはミドルウェア（NginxやApache）に証明書、中間証明書、秘密鍵を使って設定する必要があります。これが大変手間でした。そして証明書の有効期限が切れる頃には新しいものと交換しなくてはいけません。それがまた大変で。 AWSではこれらの証明書関係をAWSリソースに組み込む際にはIAMでアップデートしたり、GUIにて直接マネージメントコンソールの画面から貼り付けることでインストール、運用が出来るようになりました(ELBとか)。 API Gatew
GolangでAPI Clientを実装する
特定のAPIを利用するコマンドラインツールやサービスを書く場合はClientパッケージ（SDKと呼ばれることも多いが本記事ではClientと呼ぶ）を使うことが多いと思う．広く使われているサービスのAPIであれば大抵はオフィシャルにClientパッケージが提供されている．例えば以下のようなものが挙げられる． https://github.com/aws/aws-sdk-go https://github.com/Azure/azure-sdk-for-go https://github.com/PagerDuty/go-pagerduty https://github.com/hashicorp/atlas-go 特別使いにくい場合を除けば再実装は避けオフィシャルに提供されているものを使ってしまえばよいと思う（まともなものなら互換性などをちゃんと考慮してくれるはずなので）．一方で小さなサービ
HTTP APIの詳細なエラー情報をレスポンスに持たせるための仕様
今日では HTTP(s) で API が公開されることは当たり前の時代ですが、エラーをアプリケーションにどう伝えるかは、個々の API の設計に依存していました。特に、HTTP ステータスコードは有限であり、元々持っている意味があるので、自由に使うことはできません。API はそのドメインごとにもっと複雑で細かなエラー情報があるはずで、それらはレスポンスボディに載せてアプリケーションに伝えることになりますが、その書式に規定は今までありませんでした。 HTTP API にて、アプリケーションにエラー情報を伝達するための（レスポンスボディに載せられる）標準的な形式が、RFC7807 Problem Details for HTTP APIs で定められています。適用例としては、以下のようになります。 HTTP/1.1 403 Forbidden Content-Type: application
The Hypertext Application Language
HAL - Hypertext Application Language A lean hypermedia type Author: Mike Kelly <[email protected]> Created: 2011-06-13 Updated: 2013-09-18 (Updated) Summary HAL is a simple format that gives a consistent and easy way to hyperlink between resources in your API. Adopting HAL will make your API explorable, and its documentation easily discoverable from within the API itself. In short, it will make yo
swaggerでAPIドキュメントを書いたらめっちゃはかどった話 - kaz29
Swaggerは、REST APIの仕様とそれに関連するツール群の総称です。REST APIの仕様を定義したJSONファイル(Swagger Spec)を軸に以下のようなツールから構成されています。 Swagger UI - Swagger Spec から動的にAPIドキュメントを生成するツール Swagger Editor - Swagger Specのエディタ Swagger Codegen - Swagger Specからクライアントのコードを生成するツール 最近では、Open API InitiativeがAPIの記述のためにSwaggerを採用して話題になりました。 www.publickey1.jp APIドキュメントのメンテは結構面倒 一般的にAPIの仕様書は、古くはExcel/Wordなどを使ったり、最近ではWikiやMarkdown形式で記述したりなどプロジェクトによって
Amazon API Gateway を使って AWS 以外のサービスの API をラップする | DevelopersIO
Amazon API Gateway!!!! AWS Summit 2015 NewYork で発表＆ローンチされた新サービス「API Gateway」。社内でも社長を筆頭に愉しみながら触れています。 Amazon Lambda と連係させることで、Lambda Function を HTTP 形式の API にできるところに注目が集まっていますが、API Gateway ではそれだけではなく、外部の HTTP プロキシの API の呼び出しや各 AWS サービスの API の呼び出しも可能です。API Gateway はいろいろな可能性に満ちあふれています。 ということで今回は HTTP プロキシの API との連係機能を使って、OpenWeatherMap のラッパー的な API を作成してみたいと思います。 API の作成 それでは、API を作成していきましょう。まずはじめに「Ge
Amazon API Gateway – API作成から動作確認までやってみる | DevelopersIO
Amazon API GatewayでAPIを公開する 先日開催された「AWS Summit 2015 New York」にて、「Amazon API Gateway」が発表されました。 このサービスを利用すると、Amazon lambda functionやインターネットで公開されているアプリケーションを利用して REST APIを公開することができます。 また、Amazon API Gatewayを使用して定義した情報からJavaScriptやAndroid、iOS用のSDKを生成することもできます。 いまのところアメリカ西部（オレゴン）リージョンとアメリカ東部(バージニア)リージョン、そしてEUリージョンの提供となっているようです。 Amazon API Gatewayをつかってみる では実際にAmazon API Gatewayをつかってみましょう。 この記事ではAWS Lambd
Go言語で API サーバーを開発する | カメリオ開発者ブログ
こんにちは！白ヤギの開発者、森本です。 白ヤギではいま API サーバーを Go 言語で開発しています。 皆さんも Go の話題をよく見聞きするようになっていると思います。今回は白ヤギの業務でどんな風に Go を使って開発しているかの一端を紹介します。 余談ですが、先日、大学の先生とお話ししたときにこんな話を伺いました。その先生は学生にプログラミングを教えているそうですが、何割かの学生は及第点に届かないそうです。しかし、そういった学生がプログラミングの素養がないかというとそういう訳ではなく、プログラミングを学ぶ上でその学生にとって何が理解を促すのかが違うだけなのだと仰っていました。教える側として全ての学生が習得できるプログラミング教育というのを見つけられていないのが悔しいといった話をされていました。 何かを学ぶというのを一般論では語るのは難しいということかもしれません。そのため、私はこうい
文化庁、マンガ・アニメなどの作品情報を集約したデータベースを開設
文化庁が推進するメディア芸術デジタルアーカイブ事業は3月17日、マンガ・アニメーション・ゲーム・メディアアートの作品情報や所蔵情報をデータベースとして整備した「メディア芸術データベース（開発版）」を公開した。 同事業は、日本のメディア芸術作品の保存と活用を進めるため、基盤となるアーカイブを構築し、日本のメディア芸術の振興を図ることを目的としたもの。メディア芸術データベース（開発版）は、2010年から5年にわたって同事業が行ってきた調査結果などをまとめたものとして制作された。 データベースには、マンガ（単行本・雑誌など）約33万冊（単行本約25万冊、雑誌約8万冊）、アニメーション（テレビ放映アニメ・劇場版アニメ・OVA（オリジナルビデオアニメ）など）約9000タイトル、ゲーム（家庭用ゲーム対応ソフト・アーケードゲーム・PCゲーム）約3万5000タイトル、メディアアート（メディアアート・現代ア
[Apiary]Markdownで始めるAPI開発とAPIドキュメント作成 | DevelopersIO
APIを作るとき みなさん、毎日API使ってますか？私は、ワンライナーでAPIをコールすることにハマっています。さて、いつも使っているAPIを作る側になったとき、どのように設計していますでしょうか？また、作ったAPIをどのように使ってもらっていますか？そんな疑問に応えるサービスがApiaryです。 Apiaryとは？ Apiaryは、REST APIをサクッと書けるサービスです。また、APIドキュメントも生成してくれます。モックサーバも提供してくれます。API利用サンプルコードも作ってくれます。うん、使わないって選択肢は無いですねｗ。 無料登録すると早速使えるようになります。チームでプライベートなAPI開発をしたければ有料プランを選択してください。 API開発の流れ API開発の流れは、まずはじめにMarkdown形式でドキュメントを書きます。既にサンプルがあるのでこれを使ってみましょう。
![[Apiary]Markdownで始めるAPI開発とAPIドキュメント作成 | DevelopersIO](https://cdn-ak-scissors.b.st-hatena.com/image/square/60d7120d91185f1739fec5fcbd006f066b98e9f6/height=288;version=1;width=512/https%3A%2F%2Fdevio2023-media.developers.io%2Fwp-content%2Fuploads%2F2015%2F02%2Fapiary-logo.png){kind=logo}
REST APIドキュメント生成パターン - ✘╹◡╹✘
REST API用のドキュメントを生成するときにどうやってるかについて雑記を残しとく。 概要 実装とドキュメントの乖離を避けるためには、同じ意味情報を二箇所以上に定義することを避ける必要がある。そのための方法として、実装それ自身か、もしくは実装が参照している何らかのメタデータを元にしてドキュメントを生成したり、テストの実行結果からドキュメントを生成するというパターンがある。 テストから Cookpadでは、autodocというライブラリを利用して、RSpecでテストを実行している途中で得られたメタデータからドキュメントを生成している。これはテストの実行結果からドキュメントを生成するパターン。 これは実現方法としてはかなり特殊な部類。このパターンが最も効果的に働くのは、ドキュメント生成のために余分な開発コストはあまり掛けたくないが、テストは真面目に書いている OR 真面目に書いてほしい、とい
JSON Hyper-Schema からAPIドキュメントとGoのコードを自動生成する | The Wacul Blog
３行で言うと herokuが作ってる prmd を使って、JSON SchemaからAPIドキュメントを出力したよ！ スキーマ定義から、GoのAPI実装コードも出力するツールを作ったらめっちゃ捗るよ！ Goのバリデーション用のライブラリも作ったよ！ 今回作ったものの概要とサンプルコード 概要 以前から、APIを開発する上で、以下のようなことが課題となっていました。 そもそもドキュメント書くのがつらい それもあって、ドキュメントより先にコードが変わってしまう ドキュメントと実装の状況の違いが把握しづらい また、ロジックがそんなに複雑ではないAPIでは、実装の作業は リクエストデータのバリデーション 出力データの整形 (フィルタリング) の２つの作業が大きな割合を占めます。 APIの定義ファイルからドキュメントと、バリデーションや出力データ整形のコードを自動生成できれば、大幅に効率が上がると思
REST APIドキュメント作成ツールはapiary.ioが決定版かもしれない - Qiita
背景 APIドキュメントを書くのが楽になるツールまとめ - Qiita iodocsで便利なREST APIドキュメントを作成する - Qiita これまでずっとREST APIドキュメントをwiki上で管理していて、重たいページ上で特殊記法使ったり、スタイルの調整に時間を取られるのが辛かった。そこで良さげなドキュメントツールを色々調べてたんだけど、最終的にapiary.ioが一番良さそうという結論になってきた。 このサービスの主な特徴。 markdown記法でAPIドキュメントを記述できる ドキュメントの生成と同時にAPIのモックサーバを用意してくれる サインアップから5分くらいあればドキュメント公開できる。ドキュメントのホスト先を気にしなくてもいい。 特にドキュメントと一緒にモックを作ってくれるのは他にはないポイントでかなり便利。 使ってみる サインアップはGithubアカウントで h
「東京メトロオープンデータ活用コンテスト」②APIの仕様設計を理解し、ドキュメント化する - Qiita
成果物：apiary.ioによる、APIドキュメント とりあえず見て貰えるとイメージつかみやすいです↑ あらすじ 100万円欲しいのでAPIを利用したアプリ開発を学ぶ絶好の機会なので、東京メトロオープンデータ活用コンテストに挑戦しようとしている。 前回、とりあえずざっと触ってみてAPIのイメージは掴んだ 今回は、公式ドキュメントと実際のレスポンスを咀嚼して、仕様設計を汎用ドキュメント化しつつ理解していくことを目的とする せっかくドキュメント化するからには、汎用性と実用性が高いフォーマットとしたい（オレオレにはしたくない） 成果物 API Blueprintで記述されたテキストをApiary.ioでホスティングし、以下を作った TokyoMetroOpendataAPI · Apiary github上のソース（markdownプレビュー版） やってみてわかった、ApiaryによるAPIドキ
Qiita/Qiita Team API v2を公開しました！ - Qiita Blog
こんにちは！ r7kamuraです。 これまでQiita API v1を公開して参りましたが、このたび、より一層機能を強化したQiita API v2を公開しました。 より多くのデータにアクセス可能にQiita API v2では、これまでご要望を沢山いただいていた多くのデータへのアクセスが可能になりました。特に、テンプレート、プロジェクト、共同編集、コメントなど、Qiita Teamのデータの操作にも対応しています。 OAuthQiita API v2では、OAuth 2.0を利用した認証認可が利用可能になりました。これにより、外部のアプリケーションにパスワードを預けることなく、ユーザに関連するデータへのアクセスを許可することができます。また、発行するアクセストークンごとに権限の範囲を変更できるため、より柔軟に権限を絞れるようになりました。 個人用アクセストークンOAuthで発行できるアク
クックパッドとマイクロサービス - クックパッド開発者ブログ
技術部の高井です。 最近、日本でもマイクロサービスという言葉が流行しつつあります。 今回は、なぜクックパッドがマイクロサービスを選択したのか、また実際にどのようなやり方をしているのかということを紹介します。 Conwayの法則 ここ数年の間、クックパッドはレシピの投稿・検索サービスから「食を中心とした生活のインフラ」として事業領域を拡大しつつあります。海外レシピサービスの買収による海外展開は、単なる金銭的な関係にとどまらず、人的・技術的な交流も含めて本格化しつつあります。また、「モバイルファースト」を標語とするモバイルアプリケーションへの取り組みも加速してきました。 事業領域の拡大やグローバル展開、モバイルファーストといったビジネス要求の変化に応じて、会社の組織構造も変化しています。そして、Conwayの法則 として知られているように、組織構造とソフトウェアアーキテクチャには密接な関係があ
Gyazo API の Python ラッパー python-gyazo をリリースしました
2014/7/24 に Gyazo API が公開されました. この API を Python から簡単に利用できるようにした python-gyazo を作成しリリースしました. ソースコードは GitHub で公開しています. 使い方 こちらから Gyazo API のアプリケーション登録をして, アクセストークンを取得しておきます. python-gyazo は PyPI からインストールできます. Python 2.7 と Python 3.4 でテストしています. virtualenv を使った場合のインストール方法は以下のようになります. virtualenv venv source venv/bin/activate pip install python-gyazo 画像の取得 自分の Gyazo の画像のリストを取得して, その情報を表示する例は以下のようになります. gy
Gyazo ブログ: Gyazo API、ついに公開！全ての画像をGyazoしよう！
2014年7月24日 Gyazo API、ついに公開！全ての画像をGyazoしよう！ Gyazo API公開！ ついにGyazoのパワフルな機能が誰にでもお使い頂けるようになりました！ Gyazo APIではHTTPリクエストによるRESTfulなAPIを提供し、JSON形式のレスポンスを返すので、TwitterやAmazonS3などのAPIを触ったことがある方なら馴染みのある形式ですぐにお使い頂けます！ Gyazo APIをつかって便利なサービスを開発しましょう！ Gyazo APIはこちら Gyazo APIの主な機能 画像のアップロード ユーザーの画像一覧の取得 画像の削除 OAuthを使った認証 こちらからアプリケーションの登録やドキュメントを見ることができます。 また、先日公開されたGyazo Chrome ExtensionもGyazo APIを使用しており、Git
リリース、障害情報などのサービスのお知らせ
最新の人気エントリーの配信
j次のブックマーク
k前のブックマーク
lあとで読む
eコメント一覧を開く
oページを開く
東京メトロ、列車の在線位置など全線オープンデータ化、車両の所属会社も 
Nulab Developer API | Nulab
