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

18
APIStudy #8 SendGridにおけるStopLight活用したAPI管理

Upload: wataru-sato

Post on 29-Jan-2018

169 views

Category:

Internet


4 download

TRANSCRIPT

Page 1: SendGridにおけるStopLightを 活用したAPI管理

APIStudy #8

SendGridにおけるStopLightを

活用したAPI管理

Page 3: SendGridにおけるStopLightを 活用したAPI管理

を知ってもらう

今日の目的

Page 4: SendGridにおけるStopLightを 活用したAPI管理

StopLightについて

Page 5: SendGridにおけるStopLightを 活用したAPI管理

API Designer

API設計ツール

Hosted Docs

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

Scenarios

API設計

テスト管理

Prism管理

Prism

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

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

Page 6: SendGridにおけるStopLightを 活用したAPI管理

API Designer

Web APIのための設計ツール

Page 7: SendGridにおけるStopLightを 活用したAPI管理

API Designer

API設計ツール

Hosted Docs

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

Scenarios

API設計

テスト管理

Prism管理

Prism

Hosted Docs

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

Page 8: SendGridにおけるStopLightを 活用したAPI管理

Scenarios NEW!

テスト管理ツール

Page 9: SendGridにおけるStopLightを 活用したAPI管理

Prism

● HTTP Proxyサーバ

○ モックサーバ

○ 入出力変換

○ ロギング

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

Page 10: SendGridにおけるStopLightを 活用したAPI管理

SendGridにおけるStopLightの利用

Page 11: SendGridにおけるStopLightを 活用したAPI管理

Email Platform as a Service

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

Page 12: SendGridにおけるStopLightを 活用したAPI管理

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

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

● RESTfulな設計

SendGridのAPI

Page 13: SendGridにおけるStopLightを 活用したAPI管理

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

● テストフロー改善

● APIドキュメント公開

SendGridにおけるStopLightの利用

Page 14: SendGridにおけるStopLightを 活用したAPI管理

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

Prism

Prism

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

テスト

APIユーザーHosted Docs

SendGrid

ダッシュボード

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

SendGrid

APIサーバ

Swagger

Spec

SAKURA Internet Inc.

Page 15: SendGridにおけるStopLightを 活用したAPI管理

まとめ

Page 16: SendGridにおけるStopLightを 活用したAPI管理

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

• API設計

• テスト

• ドキュメント化

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

StopLightとは

Page 17: SendGridにおけるStopLightを 活用したAPI管理

• stoplight.io

• swagger.io

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

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

開発

参考

Page 18: SendGridにおけるStopLightを 活用したAPI管理