Improve main readme (#190)

Author: zippolyte

README.md

@@ -1,11 +1,112 @@
 # datadog-api-client-python
 
-Collection of all of the Datadog public endpoints. For the official documentation, see the [Datadog API Reference](https://docs.datadoghq.com/api/).
+This repository contains a Python API client for the [Datadog API](https://docs.datadoghq.com/api/).
+The code is generated using [openapi-generator](https://github.com/OpenAPITools/openapi-generator)
+and [apigentools](https://github.com/DataDog/apigentools).
 
-This python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project.
+Datadog API Collection
 
-Need help? Reach out to our awesome [support team](https://www.datadoghq.com/support/).
+- API version: 1.0
+
+Collection of all Datadog Public endpoints.
+
+  For more information, please visit [https://www.datadoghq.com/support/](https://www.datadoghq.com/support/)
+
+*Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*
+
+## Requirements
+
+Building and using the API client library requires:
+
+1. Python 3.6+
+
+## Installation
+
+To install the API client library, simply execute:
+
+```shell
+pip install datadog-api-client
+```
+
+## Getting Started
+
+Please follow the [installation](#installation) instruction and execute the following Python code:
+
+```python
+import os
+from dateutil.parser import parse as dateutil_parser
+import datadog_api_client.v1
+from datadog_api_client.v1.api import aws_integration_api
+from datadog_api_client.v1.models import *
+from pprint import pprint
+
+# Defining the host is optional and defaults to https://api.datadoghq.com
+# See configuration.py for a list of all supported configuration parameters.
+configuration = datadog_api_client.v1.Configuration(
+    host = "https://api.datadoghq.com"
+)
+
+# The client must configure the authentication and authorization parameters
+# in accordance with the API server security policy.
+# Examples for each auth method are provided below, use the example that
+# satisfies your auth use case.
+
+# Configure API key authorization: apiKeyAuth
+configuration.api_key['apiKeyAuth'] = os.getenv('DD_CLIENT_API_KEY')
+
+# Configure API key authorization: appKeyAuth
+configuration.api_key['appKeyAuth'] = os.getenv('DD_CLIENT_APP_KEY')
+
+# Enter a context with an instance of the API client
+with datadog_api_client.v1.ApiClient(configuration) as api_client:
+    # Create an instance of the API class
+    api_instance = aws_integration_api.AWSIntegrationApi(api_client)
+    body = AWSAccount(
+        access_key_id="access_key_id_example",
+        account_id="1234567",
+        account_specific_namespace_rules={
+            "key": True,
+        },
+        excluded_regions=["us-east-1","us-west-2"],
+        filter_tags=["<KEY>:<VALUE>"],
+        host_tags=["<KEY>:<VALUE>"],
+        role_name="DatadogAWSIntegrationRole",
+        secret_access_key="secret_access_key_example",
+    ) # AWSAccount | AWS Request Object
+
+    # example passing only required values which don't have defaults set
+    try:
+        # Create an AWS integration
+        api_response = api_instance.create_aws_account(body)
+        pprint(api_response)
+    except datadog_api_client.v1.ApiException as e:
+        print("Exception when calling AWSIntegrationApi->create_aws_account: %s\n" % e)
+```
+
+### Unstable Endpoints
+
+This client includes access to Datadog API endpoints while they are in an unstable state and may undergo breaking changes. An extra configuration step is required to enable these endpoints:
+
+```python
+configuration.unstable_operations["<OperationName>"] = True
+```
+
+where `<OperationName>` is the name of the method used to interact with that endpoint. For example: `list_log_indexes`, or `get_logs_index`
+
+## Documentation for API Endpoints and Models
+
+Documentation for API endpoints and models can be found under the [`docs`](/docs) directory. 
+
+## Documentation for Authorization
+
+Authenticate with the API by providing your API and Application keys in the configuration:
+
+```python
+configuration.api_key["apiKeyAuth"] = "YOUR_API_KEY"
+configuration.api_key["appKeyAuth"] = "YOUR_APPLICATION_KEY"
+```
 
 ## Author
 
 [email protected]
+