form_api 0.1.5 → 0.2.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.gitignore +15 -13
- data/.swagger-codegen-ignore +0 -8
- data/Gemfile +1 -0
- data/Gemfile.lock +80 -0
- data/README.md +86 -70
- data/Rakefile +0 -3
- data/docs/CreateCombinedSubmissionBody.md +11 -0
- data/docs/CreateSubmissionBatchBody.md +10 -0
- data/docs/CreateSubmissionBody.md +10 -0
- data/docs/InlineResponse200.md +8 -0
- data/docs/InlineResponse2001.md +21 -0
- data/docs/InlineResponse201.md +9 -0
- data/docs/InlineResponse2011.md +9 -0
- data/docs/InlineResponse201CombinedSubmission.md +14 -0
- data/docs/InlineResponse400.md +9 -0
- data/docs/InlineResponse401.md +8 -0
- data/docs/InlineResponse422.md +9 -0
- data/docs/PDFApi.md +482 -0
- data/docs/TemplatestemplateIdsubmissionsbatchSubmission.md +14 -0
- data/form_api.gemspec +3 -10
- data/git_push.sh +55 -0
- data/{extensions/lib → lib}/form_api/api/client.rb +2 -2
- data/lib/form_api/api/pdf_api.rb +129 -19
- data/lib/form_api/configuration.rb +1 -1
- data/lib/form_api/models/{data.rb → create_combined_submission_body.rb} +1 -1
- data/lib/form_api/models/create_submission_batch_body.rb +211 -0
- data/lib/form_api/models/{data_1.rb → create_submission_body.rb} +1 -1
- data/lib/form_api/models/inline_response_200_1.rb +400 -0
- data/lib/form_api/models/inline_response_201_1.rb +1 -1
- data/lib/form_api/models/{inline_response_201_1_submission.rb → templatestemplate_idsubmissionsbatch_submission.rb} +1 -1
- data/lib/form_api/version.rb +1 -1
- data/lib/form_api.rb +6 -4
- data/spec/api/pdf_api_spec.rb +41 -15
- data/spec/api_client_spec.rb +1 -1
- data/spec/models/{data_spec.rb → create_combined_submission_body_spec.rb} +6 -6
- data/spec/models/create_submission_batch_body_spec.rb +54 -0
- data/spec/models/{data_1_spec.rb → create_submission_body_spec.rb} +6 -6
- data/spec/models/inline_response_200_1_spec.rb +124 -0
- data/spec/models/{inline_response_201_1_submission_spec.rb → templatestemplate_idsubmissionsbatch_submission_spec.rb} +6 -6
- data/spec/vcr_cassettes/FormAPI_Client/should_generate_a_PDF_and_wait_for_the_submission_to_be_processed.yml +2 -2
- metadata +45 -47
- data/.swagger-revision +0 -1
- data/.travis.yml +0 -8
- data/CHANGELOG.md +0 -2
- data/LICENSE +0 -7
- data/examples/generate_and_download_pdf.rb +0 -60
- data/examples/generate_pdf_async.rb +0 -57
- data/examples/merge_generated_pdfs.rb +0 -31
- data/scripts/clean +0 -5
- data/scripts/fix_gemspec.rb +0 -31
- data/scripts/generate +0 -22
- data/scripts/post_generate +0 -22
- data/scripts/release +0 -6
- data/scripts/swagger +0 -35
- data/scripts/test +0 -24
- data/swagger-config.json +0 -13
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 7b00921152a148d757ec6772ee4da728448e8c3b
|
4
|
+
data.tar.gz: fedf600a57f3cfda8daf9616ddcfade8779902f8
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 304fb110f255378abfd32295b2002d968fe3b1a26d789936c5faf33d8250a0cb911c344af7fe6ffe392491aa6f44d50b978f9a06ea7a2e2d9de7143619944232
|
7
|
+
data.tar.gz: 832fc6b95b6bab276a13ba6ecc52acf7eda99c334a32b0405e9fe76feed22806a334a4070a3b9b4506855164fee829d33fbb4424efa87af23ba27a2484e0161a
|
data/.gitignore
CHANGED
@@ -1,3 +1,6 @@
|
|
1
|
+
# Generated by: https://github.com/swagger-api/swagger-codegen.git
|
2
|
+
#
|
3
|
+
|
1
4
|
*.gem
|
2
5
|
*.rbc
|
3
6
|
/.config
|
@@ -9,7 +12,11 @@
|
|
9
12
|
/test/tmp/
|
10
13
|
/test/version_tmp/
|
11
14
|
/tmp/
|
12
|
-
|
15
|
+
|
16
|
+
## Specific to RubyMotion:
|
17
|
+
.dat*
|
18
|
+
.repl_history
|
19
|
+
build/
|
13
20
|
|
14
21
|
## Documentation cache and generated files:
|
15
22
|
/.yardoc/
|
@@ -21,17 +28,12 @@
|
|
21
28
|
/.bundle/
|
22
29
|
/vendor/bundle
|
23
30
|
/lib/bundler/man/
|
24
|
-
Gemfile.lock
|
25
|
-
.ruby-version
|
26
|
-
.ruby-gemset
|
27
|
-
.rvmrc
|
28
31
|
|
29
|
-
|
30
|
-
|
32
|
+
# for a library or gem, you might want to ignore these files since the code is
|
33
|
+
# intended to run in multiple environments; otherwise, check them in:
|
34
|
+
# Gemfile.lock
|
35
|
+
# .ruby-version
|
36
|
+
# .ruby-gemset
|
31
37
|
|
32
|
-
|
33
|
-
.
|
34
|
-
Thumbs.db
|
35
|
-
|
36
|
-
## Ignore baked in swagger generator
|
37
|
-
swagger-codegen
|
38
|
+
# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
|
39
|
+
.rvmrc
|
data/.swagger-codegen-ignore
CHANGED
data/Gemfile
CHANGED
data/Gemfile.lock
ADDED
@@ -0,0 +1,80 @@
|
|
1
|
+
PATH
|
2
|
+
remote: .
|
3
|
+
specs:
|
4
|
+
form_api (0.2.0)
|
5
|
+
json (~> 2.1, >= 2.1.0)
|
6
|
+
typhoeus (~> 1.0, >= 1.0.1)
|
7
|
+
|
8
|
+
GEM
|
9
|
+
remote: https://rubygems.org/
|
10
|
+
specs:
|
11
|
+
ZenTest (4.11.1)
|
12
|
+
addressable (2.5.2)
|
13
|
+
public_suffix (>= 2.0.2, < 4.0)
|
14
|
+
autotest (4.4.6)
|
15
|
+
ZenTest (>= 4.4.1)
|
16
|
+
autotest-fsevent (0.2.13)
|
17
|
+
sys-uname
|
18
|
+
autotest-growl (0.2.16)
|
19
|
+
autotest-rails-pure (4.1.2)
|
20
|
+
byebug (10.0.2)
|
21
|
+
coderay (1.1.2)
|
22
|
+
crack (0.4.3)
|
23
|
+
safe_yaml (~> 1.0.0)
|
24
|
+
diff-lcs (1.3)
|
25
|
+
ethon (0.11.0)
|
26
|
+
ffi (>= 1.3.0)
|
27
|
+
ffi (1.9.23)
|
28
|
+
hashdiff (0.3.7)
|
29
|
+
json (2.1.0)
|
30
|
+
method_source (0.9.0)
|
31
|
+
pry (0.11.3)
|
32
|
+
coderay (~> 1.1.0)
|
33
|
+
method_source (~> 0.9.0)
|
34
|
+
pry-byebug (3.6.0)
|
35
|
+
byebug (~> 10.0)
|
36
|
+
pry (~> 0.10)
|
37
|
+
public_suffix (3.0.2)
|
38
|
+
rake (12.0.0)
|
39
|
+
rspec (3.7.0)
|
40
|
+
rspec-core (~> 3.7.0)
|
41
|
+
rspec-expectations (~> 3.7.0)
|
42
|
+
rspec-mocks (~> 3.7.0)
|
43
|
+
rspec-core (3.7.1)
|
44
|
+
rspec-support (~> 3.7.0)
|
45
|
+
rspec-expectations (3.7.0)
|
46
|
+
diff-lcs (>= 1.2.0, < 2.0)
|
47
|
+
rspec-support (~> 3.7.0)
|
48
|
+
rspec-mocks (3.7.0)
|
49
|
+
diff-lcs (>= 1.2.0, < 2.0)
|
50
|
+
rspec-support (~> 3.7.0)
|
51
|
+
rspec-support (3.7.1)
|
52
|
+
safe_yaml (1.0.4)
|
53
|
+
sys-uname (1.0.3)
|
54
|
+
ffi (>= 1.0.0)
|
55
|
+
typhoeus (1.3.0)
|
56
|
+
ethon (>= 0.9.0)
|
57
|
+
vcr (3.0.3)
|
58
|
+
webmock (1.24.6)
|
59
|
+
addressable (>= 2.3.6)
|
60
|
+
crack (>= 0.3.2)
|
61
|
+
hashdiff
|
62
|
+
|
63
|
+
PLATFORMS
|
64
|
+
ruby
|
65
|
+
|
66
|
+
DEPENDENCIES
|
67
|
+
autotest (~> 4.4, >= 4.4.6)
|
68
|
+
autotest-fsevent (~> 0.2, >= 0.2.12)
|
69
|
+
autotest-growl (~> 0.2, >= 0.2.16)
|
70
|
+
autotest-rails-pure (~> 4.1, >= 4.1.2)
|
71
|
+
form_api!
|
72
|
+
pry (~> 0.10, >= 0.10.4)
|
73
|
+
pry-byebug
|
74
|
+
rake (~> 12.0.0)
|
75
|
+
rspec (~> 3.6, >= 3.6.0)
|
76
|
+
vcr (~> 3.0, >= 3.0.1)
|
77
|
+
webmock (~> 1.24, >= 1.24.3)
|
78
|
+
|
79
|
+
BUNDLED WITH
|
80
|
+
1.16.2
|
data/README.md
CHANGED
@@ -1,105 +1,121 @@
|
|
1
|
-
#
|
1
|
+
# form_api
|
2
2
|
|
3
|
-
|
3
|
+
FormAPI - the Ruby gem for the API V1
|
4
4
|
|
5
|
-
|
6
|
-
You can use FormAPI to generate PDFs. Configure your PDF template in our online editor,
|
7
|
-
then post data to fill out the PDF.
|
5
|
+
No description provided (generated by Swagger Codegen https://github.com/swagger-api/swagger-codegen)
|
8
6
|
|
9
|
-
|
7
|
+
This SDK is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
|
10
8
|
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
* `2.1.10`
|
15
|
-
* `2.4.2`
|
9
|
+
- API version: v1
|
10
|
+
- Package version: 0.2.0
|
11
|
+
- Build package: io.swagger.codegen.languages.RubyClientCodegen
|
16
12
|
|
17
13
|
## Installation
|
18
14
|
|
19
|
-
|
20
|
-
gem install form_api
|
21
|
-
```
|
15
|
+
### Build a gem
|
22
16
|
|
23
|
-
|
17
|
+
To build the Ruby code into a gem:
|
24
18
|
|
25
|
-
```
|
26
|
-
gem
|
19
|
+
```shell
|
20
|
+
gem build form_api.gemspec
|
27
21
|
```
|
28
22
|
|
29
|
-
Then
|
23
|
+
Then either install the gem locally:
|
30
24
|
|
31
|
-
```
|
32
|
-
|
25
|
+
```shell
|
26
|
+
gem install ./form_api-0.2.0.gem
|
33
27
|
```
|
28
|
+
(for development, run `gem install --dev ./form_api-0.2.0.gem` to install the development dependencies)
|
29
|
+
|
30
|
+
or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
|
31
|
+
|
32
|
+
Finally add this to the Gemfile:
|
34
33
|
|
34
|
+
gem 'form_api', '~> 0.2.0'
|
35
35
|
|
36
|
-
|
36
|
+
### Install from Git
|
37
37
|
|
38
|
-
|
38
|
+
If the Ruby gem is hosted at a git repository: https://github.com/GIT_USER_ID/GIT_REPO_ID, then add the following in the Gemfile:
|
39
39
|
|
40
|
+
gem 'form_api', :git => 'https://github.com/GIT_USER_ID/GIT_REPO_ID.git'
|
41
|
+
|
42
|
+
### Include the Ruby code directly
|
43
|
+
|
44
|
+
Include the Ruby code directly using `-I` as follows:
|
45
|
+
|
46
|
+
```shell
|
47
|
+
ruby -Ilib script.rb
|
48
|
+
```
|
49
|
+
|
50
|
+
## Getting Started
|
51
|
+
|
52
|
+
Please follow the [installation](#installation) procedure and then run the following code:
|
40
53
|
```ruby
|
54
|
+
# Load the gem
|
55
|
+
require 'form_api'
|
56
|
+
|
57
|
+
# Setup authorization
|
41
58
|
FormAPI.configure do |config|
|
42
|
-
|
43
|
-
config.
|
59
|
+
# Configure HTTP basic authorization: api_token_basic
|
60
|
+
config.username = 'YOUR USERNAME'
|
61
|
+
config.password = 'YOUR PASSWORD'
|
44
62
|
end
|
45
63
|
|
46
|
-
|
47
|
-
|
48
|
-
response = formapi.generate_pdf(
|
49
|
-
template_id: 'YOUR_TEMPLATE_ID', # ID of a template that you have configured
|
50
|
-
test: true, # Test documents are free but watermarked
|
51
|
-
wait: true, # Wait for the PDF to be processed (default: true)
|
52
|
-
data: { # Data to render in the template
|
53
|
-
name: "foo",
|
54
|
-
number: 42
|
55
|
-
},
|
56
|
-
metadata: { # Custom data to include in the request, for your own purposes
|
57
|
-
user_id: 123
|
58
|
-
}
|
59
|
-
)
|
60
|
-
|
61
|
-
# {
|
62
|
-
# status: "success",
|
63
|
-
# submission: {
|
64
|
-
# id: "bymRSZYTKDnd6jfY",
|
65
|
-
# test: true,
|
66
|
-
# state: "processed",
|
67
|
-
# download_url: "https://..."
|
68
|
-
# }
|
69
|
-
# }
|
70
|
-
```
|
64
|
+
api_instance = FormAPI::PDFApi.new
|
71
65
|
|
72
|
-
|
66
|
+
template_id = "template_id_example" # String |
|
73
67
|
|
68
|
+
opts = {
|
69
|
+
create_submission_batch_body: [FormAPI::CreateSubmissionBatchBody.new] # Array<CreateSubmissionBatchBody> |
|
70
|
+
}
|
71
|
+
|
72
|
+
begin
|
73
|
+
#Generates multiple PDFs
|
74
|
+
result = api_instance.batch_generate_pdf(template_id, opts)
|
75
|
+
p result
|
76
|
+
rescue FormAPI::ApiError => e
|
77
|
+
puts "Exception when calling PDFApi->batch_generate_pdf: #{e}"
|
78
|
+
end
|
79
|
+
|
80
|
+
```
|
74
81
|
|
75
|
-
##
|
82
|
+
## Documentation for API Endpoints
|
76
83
|
|
77
|
-
|
84
|
+
All URIs are relative to *https://app.formapi.io/api/v1*
|
78
85
|
|
79
|
-
|
86
|
+
Class | Method | HTTP request | Description
|
87
|
+
------------ | ------------- | ------------- | -------------
|
88
|
+
*FormAPI::PDFApi* | [**batch_generate_pdf**](docs/PDFApi.md#batch_generate_pdf) | **POST** /templates/{template_id}/submissions/batch | Generates multiple PDFs
|
89
|
+
*FormAPI::PDFApi* | [**combine_submissions**](docs/PDFApi.md#combine_submissions) | **POST** /combined_submissions | Merge generated PDFs together
|
90
|
+
*FormAPI::PDFApi* | [**expire_combined_submission**](docs/PDFApi.md#expire_combined_submission) | **DELETE** /combined_submissions/{combined_submission_id} | Expire a combined submission
|
91
|
+
*FormAPI::PDFApi* | [**expire_submission**](docs/PDFApi.md#expire_submission) | **DELETE** /submissions/{submission_id} | Expire a PDF submission
|
92
|
+
*FormAPI::PDFApi* | [**generate_pdf**](docs/PDFApi.md#generate_pdf) | **POST** /templates/{template_id}/submissions | Generates a new PDF
|
93
|
+
*FormAPI::PDFApi* | [**get_combined_submission**](docs/PDFApi.md#get_combined_submission) | **GET** /combined_submissions/{combined_submission_id} | Check the status of a combined submission (merged PDFs)
|
94
|
+
*FormAPI::PDFApi* | [**get_submission**](docs/PDFApi.md#get_submission) | **GET** /submissions/{submission_id} | Check the status of a PDF
|
95
|
+
*FormAPI::PDFApi* | [**get_templates**](docs/PDFApi.md#get_templates) | **GET** /templates | Get a list of all templates
|
96
|
+
*FormAPI::PDFApi* | [**test_authentication**](docs/PDFApi.md#test_authentication) | **GET** /authentication | Test Authentication
|
80
97
|
|
81
98
|
|
82
|
-
##
|
99
|
+
## Documentation for Models
|
83
100
|
|
84
|
-
|
85
|
-
|
101
|
+
- [FormAPI::CreateCombinedSubmissionBody](docs/CreateCombinedSubmissionBody.md)
|
102
|
+
- [FormAPI::CreateSubmissionBatchBody](docs/CreateSubmissionBatchBody.md)
|
103
|
+
- [FormAPI::CreateSubmissionBody](docs/CreateSubmissionBody.md)
|
104
|
+
- [FormAPI::InlineResponse200](docs/InlineResponse200.md)
|
105
|
+
- [FormAPI::InlineResponse2001](docs/InlineResponse2001.md)
|
106
|
+
- [FormAPI::InlineResponse201](docs/InlineResponse201.md)
|
107
|
+
- [FormAPI::InlineResponse2011](docs/InlineResponse2011.md)
|
108
|
+
- [FormAPI::InlineResponse201CombinedSubmission](docs/InlineResponse201CombinedSubmission.md)
|
109
|
+
- [FormAPI::InlineResponse400](docs/InlineResponse400.md)
|
110
|
+
- [FormAPI::InlineResponse401](docs/InlineResponse401.md)
|
111
|
+
- [FormAPI::InlineResponse422](docs/InlineResponse422.md)
|
112
|
+
- [FormAPI::TemplatestemplateIdsubmissionsbatchSubmission](docs/TemplatestemplateIdsubmissionsbatchSubmission.md)
|
86
113
|
|
87
114
|
|
88
|
-
##
|
115
|
+
## Documentation for Authorization
|
89
116
|
|
90
|
-
1. Pull latest master
|
91
|
-
2. Merge feature branch(es) into master
|
92
|
-
3. `script/test`
|
93
|
-
4. Increment version in code:
|
94
|
-
- `swagger-config.json`
|
95
|
-
- `lib/formapi/version.rb`
|
96
|
-
5. Update [CHANGELOG.md](CHANGELOG.md)
|
97
|
-
6. Commit "Release version vX.Y.Z"
|
98
|
-
7. `rake release`
|
99
|
-
8. Verify package release at https://rubygems.org/gems/formapi
|
100
|
-
9. Refresh documentation on formapi.io
|
101
117
|
|
118
|
+
### api_token_basic
|
102
119
|
|
103
|
-
|
120
|
+
- **Type**: HTTP basic authentication
|
104
121
|
|
105
|
-
This library follows [Semantic Versioning 2.0.0](http://semver.org).
|
data/Rakefile
CHANGED
@@ -0,0 +1,11 @@
|
|
1
|
+
# FormAPI::CreateCombinedSubmissionBody
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**test** | **BOOLEAN** | | [optional]
|
7
|
+
**submission_ids** | **Array<String>** | |
|
8
|
+
**metadata** | **Object** | | [optional]
|
9
|
+
**expires_in** | **Float** | | [optional]
|
10
|
+
|
11
|
+
|
@@ -0,0 +1,10 @@
|
|
1
|
+
# FormAPI::CreateSubmissionBatchBody
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**test** | **BOOLEAN** | | [optional]
|
7
|
+
**data** | **Object** | |
|
8
|
+
**metadata** | **Object** | | [optional]
|
9
|
+
|
10
|
+
|
@@ -0,0 +1,10 @@
|
|
1
|
+
# FormAPI::CreateSubmissionBody
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**test** | **BOOLEAN** | | [optional]
|
7
|
+
**data** | **Object** | |
|
8
|
+
**metadata** | **Object** | | [optional]
|
9
|
+
|
10
|
+
|
@@ -0,0 +1,21 @@
|
|
1
|
+
# FormAPI::InlineResponse2001
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**id** | **String** | |
|
7
|
+
**name** | **String** | |
|
8
|
+
**template_type** | **String** | |
|
9
|
+
**public_web_form** | **BOOLEAN** | |
|
10
|
+
**public_submissions** | **BOOLEAN** | |
|
11
|
+
**expire_submissions** | **BOOLEAN** | |
|
12
|
+
**expire_after** | **Float** | | [optional]
|
13
|
+
**expiration_interval** | **String** | | [optional]
|
14
|
+
**allow_additional_properties** | **BOOLEAN** | |
|
15
|
+
**page_dimensions** | **Array<Array<Float>>** | |
|
16
|
+
**webhook_url** | **String** | |
|
17
|
+
**slack_webhook_url** | **String** | |
|
18
|
+
**redirect_url** | **String** | |
|
19
|
+
**blockchain_timestamp_verification** | **BOOLEAN** | |
|
20
|
+
|
21
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# FormAPI::InlineResponse201
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**status** | **String** | |
|
7
|
+
**combined_submission** | [**InlineResponse201CombinedSubmission**](InlineResponse201CombinedSubmission.md) | | [optional]
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,9 @@
|
|
1
|
+
# FormAPI::InlineResponse2011
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**status** | **String** | |
|
7
|
+
**submission** | [**TemplatestemplateIdsubmissionsbatchSubmission**](TemplatestemplateIdsubmissionsbatchSubmission.md) | | [optional]
|
8
|
+
|
9
|
+
|
@@ -0,0 +1,14 @@
|
|
1
|
+
# FormAPI::InlineResponse201CombinedSubmission
|
2
|
+
|
3
|
+
## Properties
|
4
|
+
Name | Type | Description | Notes
|
5
|
+
------------ | ------------- | ------------- | -------------
|
6
|
+
**id** | **String** | |
|
7
|
+
**expired** | **BOOLEAN** | |
|
8
|
+
**expires_at** | **String** | | [optional]
|
9
|
+
**state** | **String** | |
|
10
|
+
**metadata** | **Object** | | [optional]
|
11
|
+
**submission_ids** | **Array<String>** | |
|
12
|
+
**download_url** | **String** | | [optional]
|
13
|
+
|
14
|
+
|