1 files changed, 41 insertions, 0 deletions
diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..fe15887
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,41 @@
+# Net::HTTP::API
+
+## SYNOPSIS
+
+    package My::Net::API;
+    use Net::HTTP::API;
+
+    # we declare the API meta:
+    # - api_base_url   : url that will be our base
+    # - api_format     : what's the format for this API
+    # - api_format_mode: how do we set the format
+
+    net_api_declare twitter => (
+        api_base_url    => 'http://search.twitter.com/',
+        api_format      => 'json',
+        api_format_mode => 'append',
+    );
+
+    # we declare one method now:
+    # - method  : HTTP method
+    # - path    : path for the request
+    # - params  : list of params accepted for this request
+    # - required: list of required params
+
+    net_api_method search => (
+        method   => 'GET',
+        path     => '/search',
+        params   => [qw/q lang local page/],
+        required => [qw/q/],
+    );
+
+    1;
+
+    my $api = My::Net::API->new();
+    my $res = $api->search(q => 'Perl');
+
+## head1 DESCRIPTION
+
+Net::HTTP::API is a module to help to easily create a client for a web API.
+
+**THIS MODULE IS IN ITS BETA QUALITY. THE API MAY CHANGE IN THE FUTURE**