REST API

こんにちは。 エキサイト株式会社の三浦です。 REST APIにおけるHTTPメソッドには、GETやPOST、PUTやDELETEなどが存在し、APIの各エンドポイントの役割に応じて使うようになっています。 ですが、実際に開発を行っていく上では、必ずしもHTTPメソッドを使い分けることが開発のしやすさにつながるとは限りません。 今回は、REST APIを作るとき、どのHTTPメソッドを使うのがいいかの案を紹介します。 REST APIとHTTPメソッド RESTの設計で作ったAPI（REST API）では、APIのエンドポイントの役割ごとにHTTPメソッドを使い分けるのが普通です。 例えば、以…

はじめに フィヨルドブートキャンプ(以下、FBC)の「自分で考えたサービスをリリースする」という最終課題で、GitHubのREST API(REST)を利用した。(※近日リリース予定) Ruby on Railsを使って開発したのだが、RubyでGitHubAPIをたたく際に、GitHubが用意してくれている公式のラッパーライブラリ、octokit.rbを使ったらとても便利だった。 github.com サービス開発を始めた当初、「octokit.rbというラッパーライブラリがあるよ」、とGitHubの公式ドキュメントで紹介されていて存在は知っていたが、APIをたたくのが初めてなこともあり、使…

はじめに フィヨルドブートキャンプ(以下、FBC)の「自分で考えたサービスをリリースする」という最終課題で、GitHubのREST APIを利用した。(※近日リリース予定) 外部サービスのAPIをたたくのは今回が初めてで、 いきなりラッパーライブラリ*1を使ってAPIをたたこうとしたら、使い方が全く分からなかった GitHubが用意してくれているSinatraアプリでAPIをたたこうとしたら、認証の話などが出てきて大混乱 という事態に陥った。 API,ラッパーライブラリ,OAuthアプリケーションによる認証など、分からないことが同時に複数出てきて、どのようにサービス開発のための技術検証を進めて…

初めに まず、最初には、どんな環境で行ったのかと、それらの周辺知識をまとめた備忘録になります。実際にAPI開発を簡単に行なってみてAPI設計についてまとめてみよう的な記事です。 過去記事にてREST API の実装のための前提知識をまとめました。そこの知識前提なので解らなければそちらを参照ください。 最初の方はスキーマ駆動開発について簡単に説明してますので、別に興味ない場合は API設計の項目から読んで頂ければと思います。ただ、開発の部分とかはスキーマ駆動開発でやるので、知っとかないとコンテキストがおかしなるかもです。 そして、前編では普遍的なお話が多いです。後編からスキーマ駆動での開発を交え…

なぜ記事を書こうと思ったか サービスの開発中にAPI通信が動作してるか確認する必要があった為、API通信確認方法の備忘録として残す為。 おすすめのAPI通信確認方法 おすすめのAPI通信確認方法としては、コードエディタにVScodeを利用している場合、VSCodeの拡張機能である「Thunder Client」をおすすめします。 昔は「Postman」というサービスがAPI通信確認方法として利用されており、VScodeを使っていない場合は、利用するのもありだと思いますが、「Thunder Client」はVScodeで完結できる為、非常に便利です。 Postman API Platform |…

Power BI Serviceにあるワークスペースや各アーティファクト（成果物という訳ですが、最新のMSの公式ドキュメントではどうやら「アイテム」という名前に名称変更）に関する情報をREST APIで取得するニーズがあり、以下Power BI REST APIというカスタムコネクタを使ったやり方について紹介していきます。

よく見るWebAPIって言葉がよくわからなかったので、調べてまとめました。 WebAPIとは? Web上であるプログラムの機能を別のプログラムで使えるようにするための仕組み。 飲食店のレビューサイトとかでもよく見るGoogle Map APIなどが有名。 (webサイトにGooglemapの機能を埋め込める。) WebAPIの2つの実装方法 SOAP API リクエストとレスポンスをXMLの形式のデータでやり取りする。 HTTP トランスポート以外でも使用可(RESTはHTTPのみ) REST API SOAP APIのほうが使いやすく最近の主流となっている。 GET、POST、PUT、DEL…

先日 Java と Spring Boot を使って REST API のプロトタイプを作った。さらに、書籍「ユースケース駆動開発実践ガイド」で登場する ICONIX プロセスを参考にユースケース記述の工程までを試してみた。 kazuhe.hatenablog.com ICONIX プロセスを用いた設計も Java も Spring Boot も学習中なので、いろいろ雑だと思うが学びの記録として続きの工程を簡単にまとめてみる。ICONIX プロセスは工程を進めながらイテレーティブに各図を洗練されていく様なので、上記記事でのアウトプットも一部変更して再度この記事に貼り付ける。 紙芝居 作ろうとし…

どうもーキュービックでテックリードをやっている尾﨑です。 本日は会計や組織データなどのマスタ管理を行なっているNetSuiteとAPI連携した時のお話をしたいと思います。 Komawoの全体アーキテクチャ スクラッチで連携した事例は希少だと思うので、困っている方の課題解決に繋がると嬉しいです。 今回は前回のクライアント証明書認証によるREST API連携に続いて、トークンベース認証によるRESTlet API連携をご紹介したいと思います。 ・OAuth2.0トークン認証によるREST API連携 ・OAuth2.0クライアント認証によるREST API連携 ・トークンベース認証によるRESTl…

はじめに 前編 後編 技術スタック フロントエンド： バックエンド： データベース： リポジトリ Rails APIを叩いてユーザー情報をDBに保存する Railsのプロジェクトを作成する rails new .gitを削除する モジュール名を変更する データベースを作成しモデルを準備する ルーティングを設定する コントローラーを準備する フロントエンドとバックエンドの連携を設定する rack-cors axios Next.js側からRails APIを叩き、ユーザー情報をDBに保存する ユーザー情報を削除するコンポーネントも用意しておく indexページに、作成したコンポーネントを配置する…

どうもーキュービックでテックリードをやっている尾﨑です。 本日は会計や組織データなどのマスタ管理を行なっているNetSuiteとREST API連携した時のお話をしたいと思います。 Komawoの全体アーキテクチャ スクラッチで連携した事例は希少だと思うので、困っている方の課題解決に繋がると嬉しいです。 今回は前回のOAuth2.0認証に続いて、クライアント証明書認証によるREST API連携をご紹介したいと思います。 ・OAuth2.0トークン認証によるREST API連携 ・OAuth2.0クライアント認証によるREST API連携★ ・トークンベース認証によるRestlet API連携 …

Overview エムスリーエンジニアリンググループ AI・機械学習チームでソフトウェアエンジニアをしている中村(po3rin) です。検索とGoが好きです。 エムスリーではChatGPTの可能性にいち早く注目して活用を検討している段階ですが、本格的なデータ投入にはまだ懸念もあり、セキュリティチームと検討を進めている段階です。 そんな中で個人または組織のドキュメントのセマンティック検索と取得を可能にするChatGPTプラグイン「ChatGPT Retrieval Plugin」が登場しました。 github.com 情報検索好きとしては黙っていられず、外部公開用のエムスリーAI・機械学習チーム…

V3 モジュールをインストールし、UseRPSSessionを利用せずに Connect-ExchangeOnline で Exchange Online に接続している場合は、REST 接続によって接続されている状態となります。 PowerShell に接続するときに UseRPSSession スイッチExchange Online使用しない場合は、REST API コマンドレットにのみアクセスできます。 learn.microsoft.com なお、V3 モジュールでREST接続されているか確認するには、Connect-ExchangeOnlilne で接続後に、Get-Module で…

Node.jsの設計思想・動作から理解し、アプリケーション開発の実践的なスキルを身につける 2023/1に出たばかりの本です。著者の伊藤康太さんは元Yahooのスペシャリスト認定制度の黒帯保持、有識者による一冊。タイトルは「Node.js入門」とありますがNode.js本体の話にとどまらずJavaScriptの文法の話、ExpressによるWebアプリにCLIツールにフロント/バックエンド両方の開発や運用...と、実質最新のフロントエンド・バックエンド全般を概観できる本となっています。384Pなのでそんなに分厚くはないですね。 Node.jsは仕事でもインストールはしてるしたまに使うこともある…

人工知能に関するニュースは、最初に英語で発信されることが多い。 Hacker Newsは、人工知能を含む計算機科学に関するニュース記事を投稿するサイトとして英語圏で人気がある。Hacker Newsはタイトルのみが並んだシンプルな見た目で、どれが人工知能に関連するホットな記事か見分けるのが難しい。 そこで、Hacker NewsのREST APIを使い、人気順に並べ替えて、人工知能に関連する記事かをChatGPTで判定するようにした。結果は、Google Sheetsに出力するようにした。 一連の処理は、Google Apps Scriptで実装した。 Hacker News REST API…

カレンダーアプリの開発を講師と生徒の会話で説明してください。 講師：カレンダーアプリを開発するには、どのようなステップが必要か知っていますか？ 生徒：まだよくわかりませんが、何から始めたらいいでしょうか？ 講師：まずは、アプリケーションの目的と必要な機能を決定する必要があります。カレンダーアプリは、特定の日に何かを予定するためのアプリケーションであると考えられます。必要な機能としては、日付の選択、予定の追加、編集、削除、表示が考えられます。これらの機能を考慮して、どのような設計をしたらよいでしょうか？ 生徒：たぶん、データベースを使って日付と予定を管理し、UIを設計して、ユーザーが予定を追加、…

cdk-nagを触ってみた。 Security HubやAWS Configを使った設定チェックはデプロイ後のチェックになるのに比べ、cdk-nagはデプロイ前に静的解析できるのが特長。違反しているとそもそもデプロイできないので開発メンバーに確実にルールを守ってもらえる。CIにも組み込みやすい。 環境 node 16.15.0 typescript 5.0.2 aws-cdk-lib 2.70.0 constructs 10.1.289 cdk-nag 2.23.5 サンプルコードを用意 こんな感じのAPIGW+Lambda定義を用意する。 // lib/apigateway-stack.ts…

WAFによる防御が有効な攻撃として，最も適切なものはどれか。 DNSサーバに対するDNSキャッシュポイズニング REST APIサービスに対するAPIの脆弱性を狙った攻撃 SMTPサーバの第三者不正中継の脆弱性を悪用したフィッシングメールの配信 電子メールサービスに対する電子メール爆弾 解答・解説 (adsbygoogle = window.adsbygoogle || []).push({}); 解答 イ 解説 DNSサーバに対するDNSキャッシュポイズニングー REST APIサービスに対するAPIの脆弱性を狙った攻撃適切です。 SMTPサーバの第三者不正中継の脆弱性を悪用したフィッシング…

はじめに NWコンフィグの設定状況 NWコンフィグの自動取得 NTPの設定が機器ごとによって異なる NTPの設定の自動化 Ansibleを用いたNTPの設定 AWXを使用したワークフロー設定 まとめ はじめに こんにちは、SREの井上です。 本記事は、Ansibleを使用してNW機器のNetwork Time Protocol（NTP）の設定を統一した事例紹介です。以前の記事の続きになっています。 creators.oisix.co.jp NWコンフィグの設定状況 NWコンフィグの自動取得 Oisix ra daichi Inc.は、数百台のNW機器によって支えられており、NWチームによって管…