- ドローン領域のAPI仕様です。
- 空間ID仕様については以下のリンクを参照して下さい。
空間IDや座標など共通の型をProtcolBuffer形式で定義した仕様。領域横断のAPIも定義する。
仕様名 | ファイル名 |
---|---|
gRPC定義 | sdsp_g.proto |
OpenAPI仕様 | sdsp_g.swagger.json |
RESTインターフェース仕様 | rest_sdsp_g.html |
APIプロトコルには、gRPCおよびRESTを適用する。APIはProtcolBuffer形式で定義する。仕様書の可読性を上げるために、下図に示す方法でhtml化を行う。実装にあたっては、gRPCにおいてはprotoファイルを、RESTにおいてはOpenAPIを活用することを推奨する。
仕様名 | ファイル名 |
---|---|
gRPC定義 | sdsp_a.proto, object_a.proto |
gRPCインターフェース仕様 | grpc.html |
OpenAPI仕様 | sdsp_a.swagger.json |
RESTインターフェース仕様 | rest_sdsp_a.html |
- gRPC定義(sdsp_g.proto, sdsp_a.proto, object_a.proto)
- gRPCインタフェース仕様(grpc.html):gRPC定義をhtmlに整形したもの
- OpenAPI仕様(sdsp_g.swagger.json, sdsp_a.swagger.json):gRPC定義をOpenAPI表現に変換したもの
- RESTインタフェース仕様(rest_sdsp_g.html, rest_sdsp_a.html):OpenAPI仕様をhtmlに成形したもの