update README.md

Author: mahdifarzadi

README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="https://arcaptcha.ir/logo.png" height="150px"></p>
+<p align="center"><img src="https://arcaptcha.ir/_nuxt/023053fecdcdf20e40bdc993c754d487.svg" height="100px"></p>
 
 [![GoDoc](http://img.shields.io/badge/go-documentation-blue.svg?style=flat-square)](https://pkg.go.dev/github.com/arcaptcha/arcaptcha-go)
 [![License](http://img.shields.io/badge/license-mit-blue.svg?style=flat-square)](https://raw.githubusercontent.com/arcaptcha/arcaptcha-go/master/LICENSE)
@@ -7,34 +7,78 @@
 
 Arcaptcha
 =====================
-Arcaptcha library implementation in Golang to validate captcha.
+Arcaptcha library implementation in Golang to verify captcha.
 
 ## [Guide](https://arcaptcha.ir/guide)
+
 ### Installation
 
 ```
 go get -u github.com/arcaptcha/arcaptcha-go
 ```
 
 ### Usage
+
 Register on [Arcaptcha](https://arcaptcha.ir/), create website and get your own SiteKey and SecretKey
+
+```go
+website := arcaptcha.NewWebsite("YOUR_SITE_KEY", "YOUR_SECRET_KEY")
+//'arcaptcha-token' is created for each captcha
+//After you put captcha widget in your website, you can get 'arcaptcha-token' from form
+result, err := website.Verify("arcaptcha-token")
+if err != nil {
+    // error in sending or receiving API request
+    // handle error
+}
+if !result.Success {
+    // captcha not verified
+    // can see result.ErrorCodes to find what's wrong
+    // throw specific error
+}
+// it's ok
+```
+
+#### Use in middleware:
+
 ```go
 package main
 
 import (
-	"log"
+	"net/http"
 
 	"github.com/arcaptcha/arcaptcha-go"
 )
 
+var website *arcaptcha.Website
+
 func main() {
-	website := arcaptcha.NewWebsite("YOUR_SITE_KEY", "YOUR_SECRET_KEY")
-	//ChallengeID is created for each captcha
-	//After you put captcha widget in your website, you can get challengeID
-	if err := website.ValidateCaptcha("challengeID"); err != nil {
-		log.Fatal(err)
-	}
-	//Its OK
-	log.Printf("Captcha %v is valid and challenge succeeded", "challengeID")
+	website = arcaptcha.NewWebsite("YOUR_SITE_KEY", "YOUR_SECRET_KEY")
+
+	myHandler := http.HandlerFunc(handler)
+	http.Handle("/", verifyCaptcha(myHandler))
+	http.ListenAndServe(":8000", nil)
+}
+
+func handler(w http.ResponseWriter, r *http.Request) {
+	// handle request
+}
+
+func verifyCaptcha(next http.Handler) http.Handler {
+	return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
+		token := r.FormValue("arcaptcha-token")
+		result, err := website.Verify(token)
+		if err != nil {
+			// error in sending or receiving API request
+			// handle error
+		}
+		if !result.Success {
+			// captcha not verified
+			// can see result.ErrorCodes to find what's wrong
+			// throw specific error
+			return
+		}
+		// it's ok
+		next.ServeHTTP(w, r)
+	})
 }
 ```

examples/README.md

@@ -1,8 +1,9 @@
-## Arcaptcha Verification Example
+# Arcaptcha Verification Example
 
 this example is an HTTP server that serves a html form with a captcha and test the verification.
 
-### Install
+## [Guide](https://arcaptcha.ir/guide)
+### Installation
 ```shell
 go get -u github.com/arcaptcha/arcaptcha-go
 cd $GOPATH/src/github.com/arcaptcha/arcaptcha-go

examples/example.go

@@ -44,8 +44,7 @@ func handleDemo(w http.ResponseWriter, r *http.Request) {
 		_, submitted := r.Form["submitted"]
 		if submitted {
 			// can verify captcha
-			tokenForm, _ := r.Form["arcaptcha-token"]
-			token := tokenForm[0]
+			token := r.FormValue("arcaptcha-token")
 			result, err := website.Verify(token)
 			if err != nil {
 				log.Fatal(err)