よくある質問

​

適用対象について

• H5 マイクロアプリ
• ミニプログラムアプリ（組織ミニプログラムを含む）

​

サイレントログインのフロー概要

​

実行可能なサンプル

​

フロントエンドコード（H5 マイクロアプリ）

// dd SDK を使用して一時認可コードを取得
dd.ready(function() {
  dd.runtime.permission.requestAuthCode({
    corpId: "your_corp_id", // 企業 ID に置き換えてください
    onSuccess: function(result) {
      const code = result.code; // tmp_auth_code を取得
      // サーバーサイドに送信
      fetch('/api/login', {
        method: 'POST',
        body: JSON.stringify({ tmp_auth_code: code }),
        headers: { 'Content-Type': 'application/json' }
      });
    },
    onFail: function(err) {
      console.error('認可コードの取得に失敗:', err);
    }
  });
});

​

よくあるエラーコードの解説

​

errcode=40078, errmsg=存在しない一時認可コード

• サイレントログインの認可コードを正しく取得していない
  • ミニプログラムアプリの場合は dd.getAuthCode を介して取得してください。
  • H5 マイクロアプリの場合は dd.runtime.permission.requestAuthCode または dd.runtime.permission.requestOperateAuthCode を介して取得してください。
• 認可コードの有効期限切れ
  • サイレントログインの認可コードは生成後、有効期間が 5 分間 で、時間を超過すると失効します。
• 認可コードが既に使用されている
  • サイレントログインの認可コードは使い捨ての認証情報であり、一度使用すると失効するため、繰り返し呼び出すことはできません。
• 認可コードのタイプの混用
  • 例：管理コンソールのサイレントログイン認可コードを社内アプリの API に渡してユーザーの userId を取得しようとすると、このエラーが発生します。

​

errcode=41007, errmsg=無効な ssoCode

• ssoCode が存在しない、またはスペルミス
  • フロントエンドから渡された ssoCode パラメータの値が完全で、切り取られていないかを確認してください。
• ssoCode の有効期限切れ
  • ssoCode は通常、有効期間が短い（約 5 分間）ため、速やかに使用してください。
• ssoCode が既に消費されている
  • このコードは使い捨てで、他のリクエストで既に使用されている場合、後続の呼び出しは失敗します。

​

errcode=41026, errmsg=tmp_auth_code がありません

• リクエストパラメータに tmp_auth_code フィールドが含まれていない。
• パラメータ名のスペルミス（temp_auth_code や authCode など）。
• パラメータが QueryString を介して正しく渡されていない（?tmp_auth_code=xxx の形式である必要があります）。
• フロントエンドが認可コードを正常に返さず、サーバーサイドが完全なリクエストを構築できない。

解決策：フロントエンドが正しくコールバックして code の値を渡しているか確認し、サーバーサイドが tmp_auth_code パラメータを明示的に受け取るようにしてください。

​

errcode=40079, errmsg=存在しない権限付与情報

• アプリの権限付与フローがまだ完了しておらず、ユーザーがログイン確認を完了していない。
• ユーザーがアプリの可視範囲内のメンバーではない（連絡先に登録されていない、またはアクセス権が付与されていないなど）。
• アプリ権限が正しく設定されておらず、「サイレントログイン」関連の機能がオンになっていない。
• 呼び出しタイミングが早すぎ、ユーザーコンテキストが準備完了していない状態で認可コードの取得を試みている。

推奨事項：呼び出し前に判定ロジックを追加し、ユーザーがアプリにアクセスしておりクライアントサイドの環境が準備完了していることを確認してください。

​

errcode=40087, errmsg=永続認可コードの作成に失敗

• 現在のアプリタイプが永続認可コードの作成をサポートしていない。
• 必要な権限設定が不足している（「永続権限付与」権限がオンになっていないなど）。
• API の呼び出し頻度が高すぎ、レート制限メカニズムがトリガーされている。
• アプリの状態が異常（無効化されている、審査中など）。

​

errcode=40091, errmsg=tmp_auth_code がありません

• 永続認可コードの作成時に、有効な一時認可コード（tmp_auth_code）が提供されていない。
• ユーザーが権限付与アクションを完了しておらず、一時コードが空になっている。
• パラメータが作成 API に正しく渡されていない。

解決策：ユーザーに再度権限付与を促し、フロントエンドから authCode を再取得してサーバーサイドに送信し、永続認可コードの作成に使用してください。