You can browse the following URL to check the Card service:
https://127.0.0.1:8440/api/v1/card/getmessage?nowait
The response is displayed in the following format:
{ result: [<status>], cardid: <card id>, readerid: <reader id> }
The following table describes the different status that the Card service displays as a response.
Status |
Description |
---|---|
NO_READER |
The Card service has not detected the connected card reader |
READER_ON |
The Card service has detected the connected card reader |
NO_CARD |
There is no card on the reader |
CARD_ON |
A card is presented to the reader |
NOTE:The cardid parameter is used only with the CARD_ON and NO_CARD statuses.
The following table lists the GET methods and the respective response that the Card service returns.
Method |
Response |
---|---|
https://127.0.0.1:8440/api/v1/card/getmessage?nowait |
Displays the current status of the reader and card instantly. Possible status values are:
|
https://127.0.0.1:8440/api/v1/card/getmessage?wait |
Waits for the next action. For example, tapping or removal of a card from the reader. NOTE:If you disconnect the reader with a card placed on the reader, two messages NO_CARD and NO_READER are displayed. But the first one will be caught with getmessage?wait. When you connect a reader with a card on, two events READER_ON and CARD_ON take place. As a result, READER_ON is displayed as response. |
https://127.0.0.1:8440/api/v1/card/getreaderon?nowait |
Displays the current status of reader. Possible status values are:
|
https://127.0.0.1:8440/api/v1/card/getreaderon?wait |
Displays READER_ON if the reader is connected or waits till you connect the reader. |
https://127.0.0.1:8440/api/v1/card/getcardon?nowait |
Displays the current status of card. Possible status values:
|
https://127.0.0.1:8440/api/v1/card/getcardon?wait |
Displays NO_READER if a reader is not connected or waits till a card is presented on the reader. NOTE:If a card is present on the reader, the service waits for the next tap of the card. |
https://127.0.0.1:8440/api/v1/card/getcardoff?nowait&cardid=<cardid> |
Possible status values:
Use the cardid parameter to make the service wait when a specific card is removed. |
https://127.0.0.1:8440/api/v1/card/getcardoff?wait |
Possible status values:
If a card is present on the reader, the service waits till the card is removed from the reader. |
https://127.0.0.1:8440/api/abort?cancel-cookie=xxx |
All the wait methods support cancel-cookie=xxx parameter. For example, https://127.0.0.1:8440/api/v1/card/getmessage?wait&cancel-cookie=xxx. If you call abort with the cancel-cookie, all the waiting methods with the specified cookie are terminated. |