リクエスト (GET)
クライアントにて POSTレスポンスを通じて印刷ジョブがあることが通知されると、http GET要求を通じてこれを取得します。
http仕様に沿った場合、GETはリクエストbodyがなく、クエリ文字列または内部ヘッダーオプションで全てのパラメーターを送ります。
[http/https]://[cloudprntURL]?uid=<printer ID>&type=<media type>&mac=<mac address>&token=<job token>
対応機種によっては、一部のクエリパラメーターは特定のファームウェアバージョンからサポートされています:
Query Parameter |
IFBD-HI01X/HI02X |
mC-Print2/3 |
---|---|---|
token |
1.8以上 |
3.2以上 |
注釈
表に記載のないJSONパラメーター、対応機種については全てのファームウェアバージョンでサポートされています。
- uid
- サーバーで指定する”uniqueID”が設定されます。これはサーバーが Client Action 要求にて”uniqueID”を割り当てている場合にのみ含まれます。
- type
- 要求される印刷ジョブのメディアデータタイプが設定されます。サーバーは必要に応じて複数のフォームで印刷ジョブを提供します(例えば PNG, テキスト等)。その場合、クライアントは印刷可能なメディアタイプから適切なものを選び本パラメーターに設定されます。このパラメーターが省略されている場合、サーバーは任意のメディアフォーマットでデータを返します。
- mac
- クライアントからのPOST要求の"printerMAC"フィールドに使用されているプリンターMACアドレスが設定されます。
- token
- この機能は、一部機種は特定のファームウェアバージョンよりサポートしております。tokenはURLエンコードされた文字列で、サーバーより POST応答 の"jobToken"文字列が提供された場合に付与されます。これは、ジョブを一意に識別するためにサーバーが使用することができます。
サーバーは、GETリクエストによってデータが取得された後、印刷ジョブが進行中であるとみなすことができます( サーバーポーリング (POST) - JSONリクエスト - printingInProgress)。
クライアントによっては、GETリクエストの後印刷が完了するかエラーが発生するまでPOSTリクエストを停止する可能性があります(現在本仕様対応の機種はございません)。
クライアント HTTP リクエストヘッダー
対応機種ファームウェアバージョン:
Device Name |
FW Version |
---|---|
IFBD-HI01X/HI02X |
1.8以上 |
mC-Print2/3 |
3.2以上 |
TSP100IV |
1.0以上 |
TSP100IV SK |
2.0以上 |
mC-Label3 |
1.0以上 |
詳細は クライアント HTTP リクエストヘッダー を参照してください。