Conversion Status API

概要: 文書変換ジョブの実行状況を確認するAPIです。ジョブの進行状況（処理待ち、実行中、完了、失敗）をリアルタイムで監視できます。

GET /v1/user/conversions/{conversion_id}/status

変換ジョブの実行ステータスを返します。

ジョブ結果を確認するための変換ID(conversion_id)を渡します。

GET /v1/user/conversions/{conversion_id}/status

Headers

• api-key : string(required) - rokadoc APIキー

必須パラメータ

• conversion_id : string(required) - 変換ID（パスパラメータ）

オプショナルパラメータ

• space_id : string(optional) - スペース機能を利用する場合はスペースIDを指定

Request Example

Python

import requests 
import os

api_key = os.getenv("ROKADOC_API_KEY")
conversion_id = os.getenv("CONVERSION_ID")
space_id = os.getenv("SPACE_ID")

url = f"https://beta-api.rokadoc.ntt.com/v1/user/conversions/{conversion_id}/status"

headers = {
    "api-key": api_key,
    "accept": "application/json"
}

params = {}
if space_id:
    params["space_id"] = space_id

response = requests.get(url, headers=headers, params=params)

print(response.json())

curl

curl -X 'GET' \
    "https://beta-api.rokadoc.ntt.com/v1/user/conversions/${CONVERSION_ID}/status?space_id=${SPACE_ID}" \
    -H "api-key: ${ROKADOC_API_KEY}" \
    -H 'accept: application/json'

Response

200 OK - ジョブの実行状況

{
    "code": 200,
    "data": {
        "status": "Running",
        "conversion_id": "xxxx",
        "document_name": "sample.pdf"
    }
}

• code : integer - ステータスコード
• data.status : string - ジョブのステータス
  • Pending : 処理待ち
  • Running : 実行中
  • Succeeded : 完了
  • Failed : 失敗
• data.conversion_id : string - 変換ID
• data.document_name : string - ドキュメント名

422 Validation Error

{
    "detail": [
        {
            "loc": ["body", "field"],
            "msg": "Field required",
            "type": "missing"
        }
    ]
}

注意事項

• ステータスは Pending → Running → Succeeded の順で変化します
• 失敗した場合はFailedステータスが返されます