最近はエンタープライズのシステムでも、Web APIによるシステム間連携が増えてきました。そうしたときに、1リクエストで複数の連携先APIを実行し、結果をクライアントに返すということがままあります。 どう作りましょうか、という問題です。 前提として、サーバサイドでHTMLレンダリングせずに、Web APIの中継することとします。中継する意義は、流量やキャッシュをサーバサイドでコントロールできるところにあります。 クライアントから直接連携先のAPIにアクセスする設計にすると、リロードボタン連打などのDDoS攻撃うけたときに、自分たちでは対処できず、連携先に迷惑をかけてしまいますよね。特に「課金の関係などで直接APIをアクセスしなきゃいけないんだ」、とかでなければ、中継するように設計しておいた方がベターです。 Web APIの呼び出し 業務システムで使う場合は、ちゃんとリクエスト、レスポンスが

golangでAPIサーバーを開発したい！でも、何からやっていいかわからない。そんなときにはgoaがオススメだ。 goaの特徴 goaの最大の特徴はAPIデザインを書くとモック、クライアントツール、ドキュメントなどを自動生成できるところだ。 開発は以下のような手順になる。 DSLでAPIデザインを書く goagen(コードジェネレーター)で自動生成する クライアントのスケルトン テストコード CLIツール OpenAPI仕様のドキュメント APIを実装する ビルドして実行する このように人の手が入るのは「1.DLSでAPIデザインを書く」と「3.APIを実装する」だけだ。それ以外はgoagenというコードジェネレーターが自動的にやってくれる。 golang初心者の私でも、はじめて触ってから3時間くらいで動くAPIサーバーをつくることができた。 以下にgoaを使ってAPIサーバーを開発する手

JavaScriptでWeb的なプログラムを書いたことがある人は、XMLHttpRequestを使った経験もあるのではないかと思います。XMLHttpRequest，略してXHRは、JavaScript（+DOM）でサーバーとHTTP通信をするための唯一の方法としての地位を長らく保ってきましたが1、ここ3〜4年でより新しいAPIであるfetch APIが登場しました。fetch APIが出たばかりの頃は何だこのおもちゃはと正直思いましたが、いつの間にか仕様が充実していい感じになっていました。 皆さんは、この新しいAPIであるfetchをちゃんと使っているでしょうか。それとも、古いXHRを未だに使っているのでしょうか。この記事では、未だにfetchを使っていない人を主な対象としてfetchの使い方を解説します。（XHRと比較しながら解説するので$.ajaxとかaxiosとかしか使ったことがな

緊張すると声がアムロ・レイになる都元です。 ここからしばらく、キャッチコピーの迷走期が始まりますのでよろしくお付き合いください。 さて、去る 10/5 (金) 秋葉原 UDX にて開催された Developers.IO 2018、その中で 「クラスメソッドにおける Web API エンジニアリリングの基本的な考え方と標準定義」 という仰々しいタイトルで1講座持たせていただきました。 スライド 話したかったことと、話したこと 本セッションで話したかったことはだいぶ多岐にわたり、当然 40 分では話しきれないので、当初は次の 2 テーマに絞ってお話しようと考えてスライドを作っていました。 アプリケーション動作ログガイドライン RESTful / リソース指向 API 設計 しかし実際にスライドを作ってみると、それぞれで 40 分の規模となってしまい…。 ログの話は断腸の思いで見送りとさせていた

Backlog API とは Backlog API で何が出来ますか？ 課題,Wiki,ファイルの追加や取得を始め、プロジェクトやユーザーの管理などブラウザ上のBacklogでできる操作の大部分をAPIから行うことができます。詳しくはAPI リストを参照してください。 また、Cross Origin Resource Sharing (CORS) によるブラウザ上でのAjaxを使用したクロスドメイン通信が可能です。 認証 API Key 方式と OAuth 2.0 方式を提供しているため、用途に応じて使い分けることができます。詳しくは認証と認可を参照してください。 API ライブラリ 公式ライブラリ Backlog4J をはじめ、有志の開発者の方たちが提供されているライブラリを使用することで、各種プログラミング言語を使用して API にアクセスすることができます。詳しくはライブラリを参照

はじめに クリーンアーキテクチャの書籍を読んだので、実際にクリーンアーキテクチャの考え方を採用したREST APIをGO言語で実装してみた。 ↓↓↓↓ソースコード↓↓↓↓ https://github.com/yoshinorihisakawa/sample-api-hoop/tree/develop この記事ではクリーンアーキテクチャの説明というよりかは、実装ベースの実践的な内容にしている。 対象読者 ・クリーンアーキテクチャで実装されたソースコードを理解したい人 ・クリーンアーキテクチャの右下の図がよくわからない人 ・アーキテクチャについて勉強を始めた初心者 クリーンアーキテクチャとは？ クリーンアーキテクチャとは、8th Light, Inc.のブログ記事で提案されている。 一言で言うと、依存関係をコントロールし持続可能なソフトウェアを実現するための体系的な手法である。 ※ DIやD

JSON/YAMLで定義可能なHTTPモックサーバーMmockを触ってみる（シナリオに合わせて動くステートフルなモックの定義と部分的なプロキシモードの適用） JSON/YAMLで定義可能なHTTPモックサーバーMmockを触ってみました。 本記事では、「シナリオに合わせて動くステートフルなモックの定義」と「部分的なプロキシモードの適用」機能について試してみました。 こちらの記事（JSON/YAMLで定義可能なHTTPモックサーバーMmockを触ってみる）で紹介させていただいたHTTPモックサーバー、Mmockですが本記事ではもう少し踏み込んだ利用方法について紹介させていただきます。 本記事は、 シナリオに合わせて動くステートフルなモックの定義 部分的なプロキシモードの適用 の各機能を実際にMmockへ適用しながらどう設定するのか、何ができるのかを紹介いたします。 Mmock Mmock |

先月末でJDK11はRampdownフェーズに入って、機能凍結されました。 なので、今後はAPIの追加・削除・変更はほとんどないと思われます。 おそらく、機能的には現在でているea20とほとんど同じものがJava11としてリリースされることになると思います。 JDK 11 Early-Access Builds 大きな機能変更としては、ここでJEPとしてまとまっています。 「JDK 11」 http://openjdk.java.net/projects/jdk/11/ Raw String Literalが間に合わなかったのはとても残念です。JDK11トレインに乗り遅れるからがんばるぞ！みたいな投稿があって仕様をまとめてからML上は音沙汰なしですが、Rampdownフェーズが始まってから機能追加するLate Enhancement Request Processというのがあるようなので、

普段お世話になっているwebツール達の紹介です。 以下のサイトはすべて 無料 & 登録不要 です。 正規表現 regexper 正規表現を可視化してくれます。 複雑な正規表現を書くときやコードリーディングのお供に重宝します。 Rubular Rubyの正規表現をテストできます。 JSON JSON FORMATTER & VALIDATOR JSON系のツールが集まったサイト。 それぞれ、サイト名とドメインが違うのでリンクはそのうちの１つになっています。 (画像クリックでそれぞれのツールに飛べます。) ひとつずつ紹介します。 JSONをフォーマットしてくれます。 出力結果は折りたたむことができるので、長いJSONを読むときにも便利です。 JSONを含めた様々なデータ形式を変換できます。 Inputの以下に対応。 CSV INI JSON XML YAML Outputは以下に対応。 JSO

SlackのWebhook URLを取得するまでの手順を示す。 最終的にやりたいこと ChatにWebサービスの結果を通知するChatOps的なことをしたい。 通知先のChatツールとしてSlackを使用する。 Slack: Be less busy どのWebサービスを使うにしても、連携用にSlackのWebhook URLは必要になりそうなので、まずはWebhook URLを取得するまでの手順をまとめてみる。 選定理由 Slackを選んだ理由は、利用しようとしている色々なWebサービスにSlack向けのIntegrationが用意されおり、勢いがあるそうなので。以下Slackについて: 今最も勢いのあるチャットサービス「Slack」とは | TechStars Blog チャットツール「Slack」を導入しました！なかなか便利なSlash Commandsについても。 slackとgi

Assemble automations using modular, shareable, and remixable building blocks. Create modular functions that automate work in Slack and connect with your services. Share your functions so anyone can add them to their own workflows. Construct complex workflows by chaining functions together. Use your custom functions, pick from pre-defined Slack functions, or combine both to get the automations you

訳あって JIRA Core ですが、JIRA Software でも問題ありません。 REST API を使った実装の紹介 それでは本題に入ります。（と、その前に・・・ JIRA の API についての情報を ） API についての情報 JIRA 7.x になって、SOAP と XML-RPC 形式の API が削除されたようです。代わりに、REST API が台頭し充実してきています。以前は、実装されていた機能が SOAP 形式のほうが多かったため、必然的に SOAP 形式を採用していた人もいると思われますが、比較的実装が容易な REST 形式での API は、JIRA 6.x の頃から Atlassian が推奨している形式でもあるため、これからも機能の拡充などが期待されます！ なお、公式のドキュメントがシッカリしているため、API の仕様について知りたいときは下記をご覧いただくのが

この記事は Slack Advent Calendar 2016 - Qiita の3日目の記事です。 昨日は Kinoppyd さんの「今そこにあるSlack」でした。 さて、今回、この記事では golang で Slack bot を実装する方法を紹介しようと思います。 世に蔓延る Slack bot これから bot を世に放とうとしている人は、是非、１日目と２日目の記事を読み、事前知識を頭に叩き込んでおくと良いと思います。 Slackで業務チャンネルの平穏を維持するbot、そして人間のトークンをbotに与える話 - Qiita 今そこにあるSlack 基本的に、自身で作成した bot はもちろん好きになると思いますが、人によっては理解不能な bot や、意味不明な場面で反応したりと、「邪魔だな」と思われてしまうことがあります。そのため、bot を開発する人は「謙虚・尊敬・信頼」（T

弊社では、プロジェクトの課題管理にBacklogと呼ばれるサービスを利用しています。 お仕事の関係でbacklogの課題を自動生成する必要があり、せっかくなのでBacklog APIを使って課題の登録を行う方法について調べてみました。 APIキーの発行 Backlogの認証は、APIキーを利用する場合とOAuthを利用する場合の2通りがあります。今回はAPIキーを用いてAPIの操作を行います。 APIキーは、[個人設定]->[API]から、「登録」ボタンを押すことで発行できます。発行後は、下の画面にAPIキーが表示されるので、これを用いてAPIの操作を行います。 課題の登録 課題登録の動作確認用のスクリプトは以下のようになりました。 space_key, project_id, issue_type_idなどの情報は別途APIから確認しました。 import requests BASE_U