マイクロソフト系技術情報 Wiki」は、「Open棟梁Project」,「OSSコンソーシアム .NET開発基盤部会」によって運営されています。

目次

概要

WebAPIに関する情報リンクを纏めています。

詳細

インターフェイス

SOAP

  • XMLであり、古い。
  • 新規採用は、ほぼ、無い。

REST

  • HTTPメソッドのリクエストと、
  • JSONXMLのレスポンス

Swagger (OpenAPI)

  • RESTJSON系を発展させた。
  • パラメータ付きの URL テンプレート+HTTP へのカスタム マッピング

gRPC

  • バイナリ電文(Protocol Buffers
  • IDLがあるらしい。
  • 互換ライブラリが揃っている。

GraphQL

  • データクエリとデータ操作をするリクエスト。
  • 上記の結果を返す、JSONのレスポンス
  • 実装は、Schemaクラスを定義し、Queryクラスに以下を実装する。

OData

何を選択するか?

  • 好きなのを使えば良いと思いますが、以下(参考)を見て、自分は、
    • 「リクエストは、POST(form or json)
    • レスポンスは、JSONで良くない?」

派だと思いました(≒JSON-RPC)。

  • REST設計に悩むようであれば、拘らず、JSON-RPCで造ってしまえば良い。
    (「WWWブラウザから、URL直打ちのGETでJSONレスポンスを確認したい。」などの要件が無ければ)
  • 何故か?と言うと、以下の辺りが根拠になっていると思います。
    • 相互運用可能なBeanが生成される仕組みがアレばイイかな?と思います。
    • コレは、RFCなどで標準化はされていませんが、JSONパーサーの仕様が、
      言語間で似通っているため、安定して出来る芸当になっているのだと思います。

ペイロード

XML

  • リクエストにもXMLを使うと、SOAP
  • RESTでのXMLの採用は減ってきている。

JSON

リクエストにもJSONを使うと、JSON-RPC

MessagePack

Protocol Buffers

CBOR

その他

クロス ドメイン接続

WebAPIの認証

API Gateway

ツール

cURLコマンド

Postman

.NET開発

HttpClientの類の使い方

ASP.NET

ASP.NET Web Service

WCF (Windows Communication Foundation)

ASP.NET Web API


Tags: :プログラミング, :通信技術, :.NET開発, :.NET Core, :ASP.NET, :ASP.NET Web API, :ASP.NET SPA


トップ   編集 凍結 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS
Last-modified: 2020-04-21 (火) 09:05:26 (189d)