You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+27-21Lines changed: 27 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -2,7 +2,7 @@
2
2
3
3
This repository contains the source code for Dwolla's Python-based SDK, which allows developers to interact with Dwolla's server-side API via a Python API. Any action that can be performed via an HTTP request can be made using this SDK when executed within a server-side environment.
4
4
5
-
## Table of Contents
5
+
## Table of Contents
6
6
7
7
-[Getting Started](#getting-started)
8
8
-[Installation](#installation)
@@ -18,7 +18,6 @@ This repository contains the source code for Dwolla's Python-based SDK, which al
18
18
-[Community](#community)
19
19
-[Additional Resources](#additional-resources)
20
20
21
-
22
21
## Getting Started
23
22
24
23
### Installation
@@ -33,8 +32,8 @@ $ pip install dwollav2
33
32
34
33
Before any API requests can be made, you must first determine which environment you will be using, as well as fetch the application key and secret. To fetch your application key and secret, please visit one of the following links:
Finally, you can create an instance of `Client` with `key` and `secret` replaced with the application key and secret that you fetched from one of the aforementioned links, respectively.
40
39
@@ -68,7 +67,6 @@ It is highly recommended that you encrypt any token data you store.
68
67
69
68
Application access tokens are used to authenticate against the API on behalf of an application. Application tokens can be used to access resources in the API that either belong to the application itself (`webhooks`, `events`, `webhook-subscriptions`) or the Dwolla Account that owns the application (`accounts`, `customers`, `funding-sources`, etc.). Application tokens are obtained by using the [`client_credentials`](https://tools.ietf.org/html/rfc6749#section-4.4) OAuth grant type:
70
69
71
-
72
70
```python
73
71
application_token = client.Auth.client()
74
72
```
@@ -93,6 +91,7 @@ Once you've created a `Token`, currently, you can make low-level HTTP requests.
93
91
To make low-level HTTP requests, you can use the `get()`, `post()`, and `delete()` methods. These methods will return a `Response` object.
@@ -134,8 +135,8 @@ The following snippets demonstrate successful and errored responses from the Dwo
134
135
135
136
An errored response is returned when Dwolla's servers respond with a status code that is greater than or equal to 400, whereas a successful response is when Dwolla's servers respond with a 200-level status code.
136
137
137
-
138
138
##### Success
139
+
139
140
```python
140
141
res = token.get('/')
141
142
@@ -169,6 +170,7 @@ except dwollav2.NotFoundError as e:
169
170
except dwollav2.Error:
170
171
# ...
171
172
```
173
+
172
174
###### `dwollav2.Error` subclasses:
173
175
174
176
_See https://developers.dwolla.com/api-reference#errors for more info._
@@ -236,25 +238,29 @@ _See https://developers.dwolla.com/api-reference#errors for more info._
236
238
-**1.1.0** Support per-request headers
237
239
238
240
## Community
239
-
* If you have any feedback, please reach out to us on [our forums](https://discuss.dwolla.com/) or by [creating a GitHub issue](https://github.com/Dwolla/dwolla-v2-python/issues/new).
240
-
* If you would like to contribute to this library, [bug reports](https://github.com/Dwolla/dwolla-v2-python/issues) and [pull requests](https://github.com/Dwolla/dwolla-v2-python/pulls) are always appreciated!
241
-
* After checking out the repo, run `pip install -r requirements.txt` to install dependencies. Then, run `python setup.py` test to run the tests.
242
-
* To install this gem onto your local machine, `run pip install -e .`.
243
-
241
+
242
+
- If you have any feedback, please reach out to us on [our forums](https://discuss.dwolla.com/) or by [creating a GitHub issue](https://github.com/Dwolla/dwolla-v2-python/issues/new).
243
+
- If you would like to contribute to this library, [bug reports](https://github.com/Dwolla/dwolla-v2-python/issues) and [pull requests](https://github.com/Dwolla/dwolla-v2-python/pulls) are always appreciated!
244
+
- After checking out the repo, run `pip install -r requirements.txt` to install dependencies. Then, run `python setup.py` test to run the tests.
245
+
- To install this gem onto your local machine, `run pip install -e .`.
246
+
247
+
## Docker
248
+
249
+
If you prefer to use Docker to run dwolla-v2-python locally, a Dockerfile is included at the root directory.
250
+
Follow these instructions from [Docker's website](https://docs.docker.com/build/hellobuild/) to create a Docker image from the Dockerfile, and run it.
244
251
245
252
## Additional Resources
246
253
247
254
To learn more about Dwolla and how to integrate our product with your application, please consider visiting the following resources and becoming a member of our community!
0 commit comments