【API】 認定証の更新

  • 更新

Learn365 API では、認定証の有効期限、発行日、および認定証のステータスを更新できます。

ここでは、API を通じて認定証を更新する方法について説明します。

更新は、すでに発行されている PDF ファイルには適用されませんが、更新後に認定証を再発行できます。

 

認定証を更新するには、認定証の ID が必要です。認定証 ID の取得については、こちらをご参照ください。

 

API を通じた認定証の更新は、以下の手順に沿って行います。

1. https://api.365.systems/  にアクセスし、API キーで認証します。

2. Certificates セクションに移動し、PATCH /odata/v2/Certificates({Id}) Updates a Certificate partially エンドポイントを選択し、右上の「Try it out」をクリックします。

3.パラメータを入力します。

  • Id「key: Id」 フィールドに、認定証 ID を入力します。
  • Certificate:「Edit Value」フィールドに、更新するプロパティを入力します。更新しないプロパティは行全体を削除します。
    • "Status": "integer":「integer」を認定証のステータスの数値に置き換えます。
      • 有効:0
      • 期限切間近:1
      • 期限切れ:2
    • "Issued": "2025-06-29T23:14:25.0000000+00:00":入力フォーマットに従って、発行日を置き換えます。
    • "Expiry": "2025-06-29T23:14:25.0000000+00:00":入力フォーマットに従って、有効期限を置き換えます。

Update a certificate via API-1.png

 

4.「Execute」を選択してリクエストを実行します。

5.Responses ブロックで結果を確認します。

  • Code 2xx(202など)は、リクエストが正しく動作したことを示します。
  • Download オプションを使用して、APIリクエストの結果を JSON フォーマットでローカルデバイスに保存できます。

Update a certificate via API-2.png

 

更新された認定証の情報は、Learn365 管理センターとダウンロードした進捗レポートで追跡できます。既に発行されている認定証 PDF ファイルへの変更を行うことはできません。