Autogenerated Java SDK client for API V2
Java
Latest commit e14053b Aug 24, 2016 @spencerhunter spencerhunter 1.0.6 update
Permalink
Failed to load latest commit information.
src/main/java/io/swagger/client 1.0.6 update Aug 24, 2016
README.md 1.0.6 update Aug 24, 2016
pom.xml add library Oct 27, 2015

README.md

dwolla-swagger-java

The new Dwolla API V2 SDK, as generated by this fork of swagger-codegen.

Notice: This package is currently not published to Maven Central. It should be available as dwolla-swagger-java in the near future.

Version

1.0.6

Installation

To install from source:

git clone https://github.com/Dwolla/dwolla-swagger-java
cd dwolla-swagger-java
mvn install package

Quickstart

dwolla-swagger-java makes it easy for developers to hit the ground running with our API. Before attempting the following, you should ideally create an application key and secret.

Configuring a client

To get started, all you need to set is the accessToken and host values.

import io.swagger.client.ApiClient;
import io.swagger.client.api.*;
import io.swagger.client.model.*;

ApiClient a = new ApiClient();
a.setBasePath("https://api-uat.dwolla.com");
a.setAccessToken("a token");

CustomersApi c = new CustomersApi(a);

List 10 customers

Now that we've set up our client, we can use it to make requests to the API. Let's retrieve 10 customer records associated with the authorization token used.

CustomerListResponse custies = c.list(10);

Creating a new customer

To create a customer we can provide a CreateCustomer object.

CreateCustomer myNewCust = new CreateCustomer();
myNewCust.setEmail("name@mail.com");
myNewCust.setFirstName("First");
myNewCust.setLastName("Last");

Unit$ r = c.create(myNewCust);

System.out.println(r.getLocationHeader());

r.getLocationHeader() will contain a URL to your newly created resource (HTTP 201 / Location header). The Unit$ object is the base DAO; any object that has no DAO will be serialized as such.

Modules

dwolla-swagger-java contains API modules which allow the user to make requests, as well as models which are DAOs that the library uses to serialize responses.

API

Each API module is named in accordance to (Dwolla's API Spec and encapsulates all of the documented functionality.

  • AccountsApi
  • BusinessclassificationsApi
  • CustomersApi
  • DocumentsApi
  • EventsApi
  • FundingsourcesApi
  • MasspaymentitemsApi
  • OndemandauthorizationsApi
  • MasspaymentsApi
  • RootApi
  • TransfersApi
  • WebhooksApi
  • WebhooksubscriptionsApi

Models

Each model represents the different kinds of requests and responses that can be made with the Dwolla API.

  • AccountInfo
  • Amount
  • ApplicationEvent
  • Authorization
  • BaseObject
  • BusinessClassification
  • BusinessClassificationListResponse
  • CreateCustomer
  • CreateFundingSourceRequest
  • CreateWebhook
  • Customer
  • CustomerListResponse
  • Document
  • DocumentListResponse
  • EventListResponse
  • FacilitatorFeeRequest
  • FundingSource
  • FundingSourceBalance
  • FundingSourceListResponse
  • HalLink
  • MassPayment
  • MassPaymentItem
  • MicroDeposits
  • MicroDepositsInitiated
  • Money
  • RemoveBankRequest
  • Transfer
  • TransferFailure
  • TransferListResponse
  • TransferRequestBody
  • Unit
  • UpdateCustomer
  • UpdateTransfer
  • VerificationToken
  • VerifyMicroDepositsRequest
  • Webhook
  • WebhookAttempt
  • WebhookEventListResponse
  • WebhookHeader
  • WebhookHttpRequest
  • WebhookHttpResponse
  • WebhookListResponse
  • WebhookRetry
  • WebhookRetryRequestListResponse
  • WebhookSubscription

Changelog

1.0.6

  • API schema updated, MasspaymentsApi, MasspaymentitemsApi, and OndemandauthorizationsAPI now added. New methods in CustomersApi, TransfersApi, and FundingsourcesApi.

1.0.5

  • API schema error fixed, FundingSource object now has _embedded key to fix serialization issues.

1.0.4

  • API schema updated, CustomersApi has new endpoints for IAV verification.
  • Existing Customer related models updated, new VerificationToken model.
  • (version skipped, features included in 1.0.5)

1.0.3

  • API schema updated, RootApi now added.
  • Changed authToken to accessToken in compliance with RFC-6749 recommended nomenclature.

1.0.2

  • API schema updated, new methods in FundingsourcesApi.
  • All methods which take Swagger variables in path (e.g, /resource/{id}) can now be passed a resource URL to make it easier for HAL-styled API consumption.
  • More idiomatic response logic for HTTP 201 responses.

1.0.1

  • API schema updated, new methods in CustomersApi and TransfersApi

1.0.0

  • Initial release.

Credits

This wrapper is semantically generated by a fork of swagger-codegen.

License

Copyright 2015 Swagger Contributors, David Stancu

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.