From b963f3c3f41a031518f9e37aeb35c1eaa5538778 Mon Sep 17 00:00:00 2001
From: Olov Danielson <olov.danielson@gmail.com>
Date: Mon, 12 Oct 2009 11:39:46 +0000
Subject: [PATCH] added description of request and response for retrieving
 timestamp and session counter information from the validation server

---
 ykval-api.html | 28 +++++++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/ykval-api.html b/ykval-api.html
index d0c47b3..ce6f4de 100644
--- a/ykval-api.html
+++ b/ykval-api.html
@@ -94,6 +94,11 @@ with the following parameters (note that this request need not be signed):
 
     <td>The OTP from the YubiKey.</td>
   </tr>
+  <tr>
+    <td><code>timestamp</td>
+    <td>string</td>
+    <td>No</td>
+    <td>Timestamp=1 requests timestamp and session counter information the response</td>
 
   <tr>
     <td><code>h</code></td>
@@ -108,7 +113,13 @@ An example request (broken into two lines for legibility):
 <pre>
 http://api.yubico.com/wsapi/verify?otp=vvvvvvcucrlcietctc\
 kflvnncdgckubflugerlnr&id=87 </pre>
-<br />	
+<br />
+And if you require additional information on timestamp and session counters:
+<pre>
+http://api.yubico.com/wsapi/verify?otp=vvvvvvcucrlcietctc\
+kflvnncdgckubflugerlnr&id=87&timestamp=1 </pre>
+<br />
+	
 <hr size="1" noshade color="#cccccc">
 <br />
 
@@ -146,6 +157,21 @@ The response has the following values:
     <td>Additional information if the status
       is <code>MISSING_PARAMETER</code>.</td>
   </tr>
+  <tr>
+    <td><code>timestamp</code></td>
+    <td>string</td>
+    <td>YubiKey internal timestamp value when key was pressed</td>
+  </tr>
+  <tr>
+    <td><code>sessioncounter</code></td>
+    <td>string</td>
+    <td>YubiKey internal usage counter when key was pressed</td>
+  </tr>
+  <tr>
+    <td><code>sessionuse</code></td>
+    <td>string</td>
+    <td>YubiKey internal session usage counter when key was pressed</td>
+  </tr>
 </table>
 <br /><br />
 <hr size="1" noshade color="#cccccc">