サポート
このページを使って適切なサポート窓口を選び、チームが問題を素早く再現できるだけの文脈を添えてください。
最短経路
- 現在のプラットフォームの健全性と応答目標を ステータスと SLA で確認します。
- 最近の API またはプラットフォームの変更を 変更履歴 で確認します。
- 問題が継続中または業務を止めている場合は、開発者ポータルからサポートチケットを開くか、
[email protected]にメールしてください。
含めるべき内容
API、OAuth、Webhook、アプリ審査に関する問題では、次を含めてください。
- 影響を受けている環境: 本番かテストモードか。
- 分かる場合は OAuth クライアント ID またはアプリ名。
- エンドポイントのパス、HTTP メソッド、およびタイムゾーン付きの大まかなリクエスト時刻。
- レスポンスのステータスと EvoMap のエラーコード。
- UI やレスポンスヘッダーに表示された
request_id、Webhook 配信 ID、アプリ審査 ID。 - 期待した結果と実際の結果。
チケットには、アクセストークン、リフレッシュトークン、クライアントシークレット、秘密鍵、Webhook の署名シークレット、エンドユーザーの個人データ全体を送らないでください。ログを貼り付ける前にシークレットをマスクしてください。
サポートのカテゴリー
- OAuth と認証 — 同意、トークン交換、リフレッシュ、失効、イントロスペクション、OIDC ディスカバリー、JWKS、userinfo。
- 開発者 API — レシピ、ジーン、再利用クエリ、公開、べき等性、ページネーション、レート制限、エラーの契約。
- Webhook — エンドポイント登録、署名、配信リトライ、再配信、イベントペイロード、時刻のずれ。
- アプリ審査と昇格スコープ — 開発者プログラム申請の状況、アプリバージョンの審査、公開権限、スコープの昇格。
- 請求と組織アクセス — 組織 API キー、支出上限、使用量、シート、SSO、SCIM、アクセス申請。
- プラットフォームのインシデント — 障害の疑い、サービス低下、計画メンテナンス、ステータスページとの不一致。
重大度のガイド
影響に合致する最も高い重大度を使ってください。
| 重大度 | 使う場面 | 例 |
|---|---|---|
| P0 | 本番の連携が多数のユーザーに対して完全に利用できない。 | すべてのユーザーで OAuth のトークン交換が失敗する。 |
| P1 | 重要な経路が低下または利用不能だが、回避策がある。 | Webhook の配信が遅延しているが、API のポーリングは動作する。 |
| P2 | 一部のユーザーで機能が損なわれている。 | 特定のアプリバージョンの審査が止まっている。 |
| P3 | 一般的な質問、ドキュメントの不足、緊急でない不具合。 | レート制限ヘッダーや移行の詳細についての確認。 |
既存の窓口
- 開発者ポータル — サインインしている場合、アプリ固有のサポートにはこちらを使ってください。
- バグ報告ボタン — EvoMap を閲覧中に見つけたプロダクトの不具合には、フローティングのバグボタンを使ってください。
- メール — サインインできない場合や、社外の関係者を含める必要がある場合は
[email protected]を使ってください。 - GitHub ディスカッション — 非公開でなくてよい質問や例には、コミュニティディスカッションを使ってください。
非公開のサポートチケットは、必要に応じて社内のエンジニアリング管理システムにミラーされます。公開のディスカッションは、シークレット、ユーザーデータ、請求の詳細、未公開のインシデント情報には適しません。