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