From e343cbce9ffde6571cef2717e7e62df2367bb641 Mon Sep 17 00:00:00 2001
From: Stavros Papadakis <spapad@gmail.com>
Date: Fri, 23 Dec 2016 12:35:07 +0200
Subject: [PATCH] Examples added to readme

---
 base-php-client/README.md | 252 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 249 insertions(+), 3 deletions(-)

diff --git a/base-php-client/README.md b/base-php-client/README.md
index 3196bf6..00e195d 100644
--- a/base-php-client/README.md
+++ b/base-php-client/README.md
@@ -14,13 +14,259 @@
 ΀ο Ο€ΟΟŒΞ³ΟΞ±ΞΌΞΌΞ± δέχΡται τις παρακάτω παραμέτρους: 
 
 ```
-ΧρΞ�ση: index.php [--list] [--listshow] [--send <file>] [--show <hashid>] [--get <hashid>] [--save <hashid>]
-         list: λίστα hashids των Ργγράφων
-     listshow: λίστα αρχΡίων
+ΧρΞ�ση: index.php [-v] [--list] [--listshow] [-i|-o] [--send <file>] [--attach <file>] [--show <hashid>] [--get <hashid>] [--save <hashid>]
+            v: παραγωγΞ� μηνυμάτων παρακολούθησης ΡκτέλΡσης
+         list: λίστα hashids των Ργγράφων (των τΡλΡυταίων 5 ημΡρών)
+     listshow: λίστα αρχΡίων (των τΡλΡυταίων 5 ημΡρών)
+            i: Ξ½Ξ± συμπΡριληφθούν μόνο τα Ξ΅ΞΉΟƒΞ΅ΟΟ‡ΟŒΞΌΞ΅Ξ½Ξ± στη λίστα αρχΡίων
+            ΞΏ: Ξ½Ξ± συμπΡριληφθούν μόνο τα Ξ΅ΞΎΞ΅ΟΟ‡ΟŒΞΌΞ΅Ξ½Ξ± στη λίστα αρχΡίων
   send <file>: ΞΊΞ±Ο„Ξ±Ο‡ΟŽΟΞ·ΟƒΞ· Ο€ΟΟ‰Ο„ΞΏΞΊΟŒΞ»Ξ»ΞΏΟ… ΞΌΞ΅ αποστολΞ� του αρχΡίου file
+attach <file>: Ξ΅Ο€ΞΉΟƒΟΞ½Ξ±ΟˆΞ· αρχΡίου στην ΞΊΞ±Ο„Ξ±Ο‡ΟŽΟΞ·ΟƒΞ· (Ο€ΞΏΞ»Ξ»Ξ±Ο€Ξ»ΟŒ)
   show <hash>: αναλυτικές πληροφορίΡς αρχΡίου ΞΌΞ΅ δΡδομένο hashid
    get <hash>: Ξ»Ξ�ψη  αρχΡίου ΞΌΞ΅ δΡδομένο hashid
   save <hash>: Ξ»Ξ�ψη ΞΊΞ±ΞΉ αποθΞ�κΡυση αρχΡίου ΞΌΞ΅ δΡδομένο hashid
                στον τρέχοντα φάκΡλο ΞΊΞ±ΞΉ ΞΌΞ΅ το όνομα αρχΡίου που ΡπιστρέφΡται
 ```
 
+## ΠαραδΡίγματα ΞΊΞ»Ξ�σης
+
+### Λίστα Ργγράφων 
+
+```sh
+$ php index.php --list 
+Ανάκτηση API key...
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.h_vUGpeFjhajdlMFAwZVTnuNPwVXxHfc6ehWnpLHvik
+Ανάκτηση λίστας Ργγράφων...
+Λίστα Ργγράφων: 
+Bl5BEZPKGztl2lcmtEWMgQ%3D%3D
+r%2BhOqWinF8U%2FPKM6RDn45g%3D%3D
+ai2nYtQPsm5iWacd1NEEYw%3D%3D
+69t%2FYlgsEJjQMiWkPUFpFQ%3D%3D
+XJL2Whs6%2FBsu6ObQ%2FpeMlw%3D%3D
+QiQ8VaRYeItETkqP%2FKjTVQ%3D%3D
+ELTKEUX%2B0FLyivlIm%2Bm0uw%3D%3D
+OrDAz8L9tF0AGSGutQ0Hxw%3D%3D
+lmyplemnNoaMR0W6TU0uqg%3D%3D
+%2F%2FvoXi7pZMVHdFvVlTTLGQ%3D%3D
+GHotM8CWL%2FvGPjabwzHhqg%3D%3D
+NU6CEaLymbOjqzla1iSuyQ%3D%3D
+22UMz%2B55qhqJhy2AL0Ihtg%3D%3D
+vhX1LPAxgI8VTHpXrXzNIQ%3D%3D
+tbAP3jdzbrj%2BtB9prn1s2w%3D%3D
+1Lph6VjgxqRjVhiyMNNgTg%3D%3D
+L3Wwrt54uCCyAqoCN51enA%3D%3D
+HN9eLwiPjsKncOxfWsFlKw%3D%3D
+RLjZIIroC0WTWARa8iPxjw%3D%3D
+IFFnDJWBuWhtpQhvlzPyMQ%3D%3D
+K7ga1NQ2wONXb3364Q9Elg%3D%3D
+OblOuYKCQEdnwH1PFBstxA%3D%3D
+rSOTUDYNkHWBDktlAP31Hg%3D%3D
+Done.
+```
+
+**ΠαράδΡιγμα μΡ verbose output**
+
+```sh
+$ php index.php --list -v
+Ανάκτηση API key...
+getApiKey :: payload: {"username":"test","password":"123456"}
+*   Trying 195.251.16.162...
+* Connected to protocoltest.minedu.gov.gr (195.251.16.162) port 443 (#0)
+* ALPN, offering http/1.1
+* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH
+* successfully set certificate verify locations:
+*   CAfile: /etc/ssl/certs/ca-certificates.crt
+  CApath: /etc/ssl/certs
+* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
+* ALPN, server did not agree to a protocol
+* Server certificate:
+*        subject: C=GR; ST=Athens; L=Maroussi; O=Greek Ministry of Education; OU=IT; CN=protocoltest.minedu.gov.gr
+*        start date: Aug  5 00:00:00 2016 GMT
+*        expire date: Aug 14 12:00:00 2019 GMT
+*        subjectAltName: protocoltest.minedu.gov.gr matched
+*        issuer: C=NL; ST=Noord-Holland; L=Amsterdam; O=TERENA; CN=TERENA SSL CA 3
+*        SSL certificate verify ok.
+> PUT /openpapyros/api/pauthenticate/pauth HTTP/1.1
+Host: protocoltest.minedu.gov.gr
+User-Agent: OSTEAM barebone php client
+Content-Type: application/json
+Accept: application/json
+Content-Length: 39
+
+* upload completely sent off: 39 out of 39 bytes
+< HTTP/1.1 200 OK
+< Date: Fri, 23 Dec 2016 10:33:51 GMT
+< Server: Apache
+< X-Powered-By: Modus/Undertow/1
+< Content-Type: application/json
+< Content-Length: 101
+< Vary: Accept-Encoding
+< 
+* Connection #0 to host protocoltest.minedu.gov.gr left intact
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.X6fRd7StTnSIq11S7IpjaMSTP3540ypEfXV6sJRWujk
+Ανάκτηση λίστας Ργγράφων...
+searchDocuments :: payload: {"senderId":100000001,"docType":null,"startDate":"2016-12-18T00:00:00+02:00","endDate":"2016-12-23T12:33:52+02:00"}
+* Hostname protocoltest.minedu.gov.gr was found in DNS cache
+*   Trying 195.251.16.162...
+* Connected to protocoltest.minedu.gov.gr (195.251.16.162) port 443 (#0)
+* ALPN, offering http/1.1
+* Cipher selection: ALL:!EXPORT:!EXPORT40:!EXPORT56:!aNULL:!LOW:!RC4:@STRENGTH
+* successfully set certificate verify locations:
+*   CAfile: /etc/ssl/certs/ca-certificates.crt
+  CApath: /etc/ssl/certs
+* SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
+* ALPN, server did not agree to a protocol
+* Server certificate:
+*        subject: C=GR; ST=Athens; L=Maroussi; O=Greek Ministry of Education; OU=IT; CN=protocoltest.minedu.gov.gr
+*        start date: Aug  5 00:00:00 2016 GMT
+*        expire date: Aug 14 12:00:00 2019 GMT
+*        subjectAltName: protocoltest.minedu.gov.gr matched
+*        issuer: C=NL; ST=Noord-Holland; L=Amsterdam; O=TERENA; CN=TERENA SSL CA 3
+*        SSL certificate verify ok.
+> POST /openpapyros/api/search/documents HTTP/1.1
+Host: protocoltest.minedu.gov.gr
+User-Agent: OSTEAM barebone php client
+api_key: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.X6fRd7StTnSIq11S7IpjaMSTP3540ypEfXV6sJRWujk
+Content-Type: application/json
+Accept: application/json
+Content-Length: 115
+
+* upload completely sent off: 115 out of 115 bytes
+< HTTP/1.1 200 OK
+< Date: Fri, 23 Dec 2016 10:33:52 GMT
+< Server: Apache
+< X-Powered-By: Modus/Undertow/1
+< Content-Type: application/json
+< Content-Length: 740
+< Vary: Accept-Encoding
+< 
+* Connection #0 to host protocoltest.minedu.gov.gr left intact
+Λίστα Ργγράφων: 
+Bl5BEZPKGztl2lcmtEWMgQ%3D%3D
+r%2BhOqWinF8U%2FPKM6RDn45g%3D%3D
+ai2nYtQPsm5iWacd1NEEYw%3D%3D
+69t%2FYlgsEJjQMiWkPUFpFQ%3D%3D
+XJL2Whs6%2FBsu6ObQ%2FpeMlw%3D%3D
+QiQ8VaRYeItETkqP%2FKjTVQ%3D%3D
+ELTKEUX%2B0FLyivlIm%2Bm0uw%3D%3D
+OrDAz8L9tF0AGSGutQ0Hxw%3D%3D
+lmyplemnNoaMR0W6TU0uqg%3D%3D
+%2F%2FvoXi7pZMVHdFvVlTTLGQ%3D%3D
+GHotM8CWL%2FvGPjabwzHhqg%3D%3D
+NU6CEaLymbOjqzla1iSuyQ%3D%3D
+22UMz%2B55qhqJhy2AL0Ihtg%3D%3D
+vhX1LPAxgI8VTHpXrXzNIQ%3D%3D
+tbAP3jdzbrj%2BtB9prn1s2w%3D%3D
+1Lph6VjgxqRjVhiyMNNgTg%3D%3D
+L3Wwrt54uCCyAqoCN51enA%3D%3D
+HN9eLwiPjsKncOxfWsFlKw%3D%3D
+RLjZIIroC0WTWARa8iPxjw%3D%3D
+IFFnDJWBuWhtpQhvlzPyMQ%3D%3D
+K7ga1NQ2wONXb3364Q9Elg%3D%3D
+OblOuYKCQEdnwH1PFBstxA%3D%3D
+rSOTUDYNkHWBDktlAP31Hg%3D%3D
+Done.
+```
+
+### Ξ ΟΟ‰Ο„ΞΏΞΊΟŒΞ»Ξ»Ξ·ΟƒΞ· Ργγράφου 
+
+**ΜΡ συνημμένο αρχΡίο**
+
+```sh
+$ php index.php --send /tmp/test-file2.pdf --attach /tmp/test-file.pdf 
+Ανάκτηση API key...
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.-5lgafnO-ACRSchNQQhUpx8RfuZnGQtvF9-eIl9EJsY
+ΑποστολΞ� Ργγράφου...
+ΞˆΞ»Ξ΅Ξ³Ο‡ΞΏΟ‚ Ξ³ΞΉΞ± το αρχΡίο /tmp/test-file2.pdf... OK
+ΞˆΞ»Ξ΅Ξ³Ο‡ΞΏΟ‚ Ξ³ΞΉΞ± το συνημμένο αρχΡίο /tmp/test-file.pdf... OK
+Ξ— αποστολΞ� ολοκληρώθηκΡ ΞΌΞ΅ ΑΑ.Ξ .: 180042
+Αναλυτικά: Array
+(
+    [docId] => rSOTUDYNkHWBDktlAP31Hg%3D%3D
+    [protocolYear] => 2016
+    [protocolDate] => 23/12/2016
+    [protocolNumber] => 180042
+    [attachments] => Array
+        (
+            [0] => Array
+                (
+                    [docId] => 7Kv7cp7J5fQRXyw7R1mEGQ%3D%3D
+                    [description] => 
+                )
+
+        )
+
+)
+
+Done.
+```
+
+### ΛΡπτομέρΡιΡς Ο€ΟΟ‰Ο„ΞΏΞΊΟŒΞ»Ξ»ΞΏΟ… 
+
+```sh
+$ php index.php --show "rSOTUDYNkHWBDktlAP31Hg%3D%3D"
+Ανάκτηση API key...
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.UD9kmeoxUiytUiKBuq6ckeRkwlGoBmwLETlpNdtbX7Q
+ΛΡπτομέρΡιΡς Ργγράφου: 
+Array
+(
+    [id] => rSOTUDYNkHWBDktlAP31Hg%3D%3D
+    [protocolNumber] => 180042
+    [protocolDate] => 23/12/2016
+    [docType] => 7
+    [sender] => 100000001
+    [senderProtocol] => 
+    [senderDateProtocol] => 
+    [docCategory] => 20
+    [theme] => Ξ”ΞŸΞšΞ™ΞœΞ—: Αυτοματοποιημένο κΡίμΡνο της 2016-12-23T12:27:06+02:00
+    [ada] => 
+    [attachedDocsDescr] => Ξ”ΞŸΞšΞ™ΞœΞ—: Αυτοματοποιημένο κΡίμΡνο πΡριγραφΞ�Ο‚ 20161223121227
+    [director] => Ξ”ΞŸΞšΞ™ΞœΞ—: Αυτοματοποιημένο κΡίμΡνο πΡριγραφΞ�Ο‚ 20161223121227
+    [attachedId] => Array
+        (
+            [0] => 7Kv7cp7J5fQRXyw7R1mEGQ%3D%3D
+        )
+
+)
+
+Done.
+```
+
+### ΠληροφορίΡς αρχΡίου 
+
+```sh
+$ php index.php --get "rSOTUDYNkHWBDktlAP31Hg%3D%3D"
+Ανάκτηση API key...
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.S70EW5ruMkAzxg4QaY0izZj0xSF_jeRrTvMiOf7DC10
+ΛΡπτομέρΡιΡς Ργγράφου: 
+Array
+(
+    [document] => Array
+        (
+            [base64] => go=
+        )
+
+    [fileName] => test-file2.pdf
+    [description] => ΕΙΣ - 180042 - 2016
+)
+
+Done.
+
+```
+
+### Ξ›Ξ�ψη αρχΡίου 
+
+```sh
+$ php index.php --save "7Kv7cp7J5fQRXyw7R1mEGQ%3D%3D"
+Ανάκτηση API key...
+΀ο API key Ρίναι: eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiIxMDAwMDAwIn0.WLTS9UxlPDZw-1WsjWush7HXzYWRjazJMEYR8Q58mjo
+ΛΡπτομέρΡιΡς αποθΞ�κΡυσης Ργγράφου: 
+Array
+(
+    [file_name] => test-file.pdf
+    [description] => Ξ”ΞŸΞšΞ™ΞœΞ—: ΑποστολΞ� συνημμένου δοκιμαστικού αρχΡίου /tmp/test-file.pdf
+    [save] => ΑποθηκΡύτηκΡ
+)
+
+Done.
+```
-- 
GitLab