sendgridにおけるstoplightを 活用したapi管理

APIStudy #8

SendGridにおけるStopLightを

活用したAPI管理

自己紹介

佐藤 航構造計画研究所

（SendGrid日本代理店）

グラフデータベース入門〜Neo4jを使う〜

を知ってもらう

今日の目的

StopLightについて

API Designer

API設計ツール

Hosted Docs

ユーザ向けのドキュメント公開

Scenarios

API設計

テスト管理

Prism管理

Prism

API管理を支援するサービス

Swagger Spec/RAMLを中心としたAPI管理サービス

API Designer

Web APIのための設計ツール

API Designer

API設計ツール

Hosted Docs

ユーザ向けのドキュメント公開

Scenarios

API設計

テスト管理

Prism管理

Prism

Hosted Docs

ユーザー向けドキュメントのホスティングサービス

Scenarios NEW!

テスト管理ツール

Prism

● HTTP Proxyサーバ

○ モックサーバ

○ 入出力変換

○ ロギング

API設計とテスト支援のためのProxyサーバ

SendGridにおけるStopLightの利用

Email Platform as a Service

メールに関するあらゆる機能をAPIで提供するSaaS

● エンドポイント数200以上

● メール送信他、ほぼ全ての機能にアクセス可

● RESTfulな設計

SendGridのAPI

● 既存APIからのSwagger Specファイル生成

● テストフロー改善

● APIドキュメント公開

SendGridにおけるStopLightの利用

SendGridにおけるStopLightの利用準備（既存APIからのSwagger Specファイル生成）

Prism

Prism

APIライブラリ モックサーバ

テスト

APIユーザーHosted Docs

SendGrid

ダッシュボード

テストフロー改善 APIドキュメント公開

SendGrid

APIサーバ

Swagger

Spec

SAKURA Internet Inc.

まとめ

• Swagger Specを中心としたサービス

• API設計

• テスト

• ドキュメント化

• シンプルで使いやすいツール群

StopLightとは

• stoplight.io

• swagger.io

• SwaggerでRESTful APIの管理を楽にする

• Swaggerで始めるモデルファーストなAPI

開発

参考