失敗したZapier実行を調べる

dosyaのステップはほとんどの失敗についてAPIのエラー文とHTTPステータスを保持します。認証、フォルダーに制限されたキー、回数制限のレスポンスは異なるZapierエラーに変換されるため、応答の種類で次の操作を判断します。

手順

1. Zapierの履歴で失敗したZapの実行を開き、後続のスキップされたステップではなく、最初に失敗したdosyaステップを選択してください。
2. Zap名、実行ID、ステップ名、時刻、HTTPステータス、機密情報を除いたdosyaのレスポンスを記録してください。dos_… APIキー、Authorizationヘッダー、アクセスコード、受信者の秘密情報は絶対にコピーしないでください。
3. 401は接続の失敗として扱ってください。連携はZapierの再接続が必要なエラーを返します。認証情報を現在有効なフルアクセスでフォルダー制限のないキーに交換してください。
4. 403は正確なメッセージを確認してください。フォルダーに制限されたキーには**Create a key with no folder anchor and full scope, then reconnect.**という修正方法が表示されます。読み取り専用またはアップロード専用キーもWebhookトリガーには不十分です。
5. 429ではRetry-Afterの値を保持してください。dosyaはその待機時間を使う回数制限エラーを返し、使用できるヘッダーがない場合は60秒を使用します。
6. その他のステータスでは再実行前に保存したdosyaのメッセージやマッピングした入力を修正してください。タイムアウト後はdosyaに結果がすでに作成されていないか確認してください。Zapierが応答を失う前に一部の操作が成功した可能性があります。

認証情報を扱うミドルウェアは正確なdosya APIオリジンにのみキーを付け、認証済みリクエストではリダイレクトを追跡しません。そのため、サードパーティのファイル元での失敗はdosyaの再接続問題と誤表示されず、そのプロバイダーのエラーとして扱われます。

期待される結果

失敗した実行を1つのステップ、リクエストの種類、秘密情報を含まない証拠に結び付けられます。認証失敗では再接続し、回数制限では指定された時間を待ち、入力や権限の問題を修正し、成否が不明な書き込みは再実行前に確認します。

関連ガイド

• dosyaをZapierに接続する
• Zapierの問題を解決する