Skip to content

Commit 6014d9c

Browse files
committed
Updated on 2020-09-12 21:56:57. Version: 1.1.0
1 parent 1ae8ac0 commit 6014d9c

50 files changed

Lines changed: 4815 additions & 1300 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

CHANGELOG.md

Lines changed: 6 additions & 46 deletions
Original file line numberDiff line numberDiff line change
@@ -1,49 +1,9 @@
1-
### 1.13.0 [October 10, 2019]
1+
### 1.1.0 [September 12, 2020]
22

3-
- Add permanent_download_url attribute to Submission model
3+
- **BREAKING CHANGE**: Renamed createTemplate operation to createPDFTemplate
4+
- Added createHTMLTemplate operation. (This uses the same API endpoint as createPDFTemplate, but the example shows how to set html, scss, etc. fields)
5+
- Added updateTemplate operation, to update a PDF or HTML template
46

5-
### 1.12.0 [October 9, 2019]
7+
### 1.0.0 [May 20, 2019]
68

7-
- Add parent folder ID and path params to GET template response
8-
- Add parent folder ID param when creating a new template, so you can upload a template into a folder
9-
10-
### 1.11.0 [July 31, 2019]
11-
* Added Create Folder, List Folder, Move to Folder endpoints
12-
* **BREAKING CHANGE** Added parent_folder_id query parameter to "List Templates".
13-
14-
### 1.10.1 [July 3, 2019]
15-
16-
- Fixed combineSubmissions and combinePdfs helpers when "strict mode" is enabled by setting error_reporting
17-
18-
### 1.10.0 [July 3, 2019]
19-
20-
- Added combinePdfs wrapper that handles polling and doesn't return a pending combined submission job
21-
22-
### 1.9.0 [June 22, 2019]
23-
24-
- **BREAKING CHANGE** Renamed "Get Templates" endpoint to "List Templates". Added a search query parameter.
25-
26-
### 1.8.0 [April 11, 2019]
27-
28-
- Added support for editable PDFS (editable: true)
29-
30-
### 1.7.0 [December 23, 2018]
31-
32-
- Added CustomFiles, and combinePdf call to support many different types of source PDFs. Renamed a few models
33-
34-
### 1.6.0 [December 18, 2018]
35-
36-
- Updated API host to api.formapi.io
37-
38-
### 1.5.0 [December 13, 2018]
39-
40-
- Fix model name for newly created Templates (PendingTemplate)
41-
- Added "actions" to submission and combined_submission responses. Includes information about custom S3 uploads
42-
43-
### 1.4.0 [December 1, 2018]
44-
45-
- Added Create Template, Get Template, and Get Template Schema endpoints
46-
47-
### 1.3.1 [November 4, 2018]
48-
49-
- Initial changelog
9+
- Renamed FormAPI to DocSpring. (View the CHANGELOG in the original FormAPI API client for prior releases.)

README.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ DocSpring is a service that helps you fill out and sign PDF templates.
44
This PHP package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
55

66
- API version: v1
7-
- Package version: 1.0.0
7+
- Package version: 1.1.0
88
- Build package: com.docspring.codegen.DocSpringPhpClientCodegen
99

1010
## Requirements
@@ -94,8 +94,9 @@ Class | Method | HTTP request | Description
9494
*PDFApi* | [**createCustomFileFromUpload**](docs/Api/PDFApi.md#createcustomfilefromupload) | **POST** /custom_files | Create a new custom file from a cached presign upload
9595
*PDFApi* | [**createDataRequestToken**](docs/Api/PDFApi.md#createdatarequesttoken) | **POST** /data_requests/{data_request_id}/tokens | Creates a new data request token for form authentication
9696
*PDFApi* | [**createFolder**](docs/Api/PDFApi.md#createfolder) | **POST** /folders/ | Create a folder
97-
*PDFApi* | [**createTemplate**](docs/Api/PDFApi.md#createtemplate) | **POST** /templates | Upload a new PDF template with a file upload
98-
*PDFApi* | [**createTemplateFromUpload**](docs/Api/PDFApi.md#createtemplatefromupload) | **POST** /templates?v=2 | Create a new PDF template from a cached presign upload
97+
*PDFApi* | [**createHTMLTemplate**](docs/Api/PDFApi.md#createhtmltemplate) | **POST** /templates?desc=html | Create a new HTML template
98+
*PDFApi* | [**createPDFTemplate**](docs/Api/PDFApi.md#createpdftemplate) | **POST** /templates | Create a new PDF template with a form POST file upload
99+
*PDFApi* | [**createPDFTemplateFromUpload**](docs/Api/PDFApi.md#createpdftemplatefromupload) | **POST** /templates?desc=cached_upload | Create a new PDF template from a cached presign upload
99100
*PDFApi* | [**deleteFolder**](docs/Api/PDFApi.md#deletefolder) | **DELETE** /folders/{folder_id} | Delete a folder
100101
*PDFApi* | [**expireCombinedSubmission**](docs/Api/PDFApi.md#expirecombinedsubmission) | **DELETE** /combined_submissions/{combined_submission_id} | Expire a combined submission
101102
*PDFApi* | [**expireSubmission**](docs/Api/PDFApi.md#expiresubmission) | **DELETE** /submissions/{submission_id} | Expire a PDF submission
@@ -114,6 +115,7 @@ Class | Method | HTTP request | Description
114115
*PDFApi* | [**renameFolder**](docs/Api/PDFApi.md#renamefolder) | **POST** /folders/{folder_id}/rename | Rename a folder
115116
*PDFApi* | [**testAuthentication**](docs/Api/PDFApi.md#testauthentication) | **GET** /authentication | Test Authentication
116117
*PDFApi* | [**updateDataRequest**](docs/Api/PDFApi.md#updatedatarequest) | **PUT** /data_requests/{data_request_id} | Update a submission data request
118+
*PDFApi* | [**updateTemplate**](docs/Api/PDFApi.md#updatetemplate) | **PUT** /templates/{template_id} | Update a Template
117119

118120

119121
## Documentation For Models
@@ -135,6 +137,7 @@ Class | Method | HTTP request | Description
135137
- [CreateSubmissionDataRequestTokenResponseToken](docs/Model/CreateSubmissionDataRequestTokenResponseToken.md)
136138
- [CreateSubmissionResponse](docs/Model/CreateSubmissionResponse.md)
137139
- [CreateTemplateData](docs/Model/CreateTemplateData.md)
140+
- [CreateTemplateData1](docs/Model/CreateTemplateData1.md)
138141
- [CustomFile](docs/Model/CustomFile.md)
139142
- [Error](docs/Model/Error.md)
140143
- [Folder](docs/Model/Folder.md)
@@ -152,11 +155,14 @@ Class | Method | HTTP request | Description
152155
- [SubmissionDataBatchRequest](docs/Model/SubmissionDataBatchRequest.md)
153156
- [SubmissionDataRequest](docs/Model/SubmissionDataRequest.md)
154157
- [Template](docs/Model/Template.md)
155-
- [Templatesv2Template](docs/Model/Templatesv2Template.md)
156-
- [Templatesv2TemplateDocument](docs/Model/Templatesv2TemplateDocument.md)
157-
- [Templatesv2TemplateDocumentMetadata](docs/Model/Templatesv2TemplateDocumentMetadata.md)
158+
- [TemplatesdesccachedUploadTemplate](docs/Model/TemplatesdesccachedUploadTemplate.md)
159+
- [TemplatesdesccachedUploadTemplateDocument](docs/Model/TemplatesdesccachedUploadTemplateDocument.md)
160+
- [TemplatesdesccachedUploadTemplateDocumentMetadata](docs/Model/TemplatesdesccachedUploadTemplateDocumentMetadata.md)
161+
- [TemplatestemplateIdTemplate](docs/Model/TemplatestemplateIdTemplate.md)
158162
- [UpdateDataRequestResponse](docs/Model/UpdateDataRequestResponse.md)
159163
- [UpdateSubmissionDataRequestData](docs/Model/UpdateSubmissionDataRequestData.md)
164+
- [UpdateTemplateData](docs/Model/UpdateTemplateData.md)
165+
- [UpdateTemplateResponse](docs/Model/UpdateTemplateResponse.md)
160166

161167

162168
## Documentation For Authorization

composer.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "docspring/docspring",
3-
"version": "1.0.0",
3+
"version": "1.1.0",
44
"description": "",
55
"keywords": [
66
"openapitools",

docs/Api/PDFApi.md

Lines changed: 123 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -11,8 +11,9 @@ Method | HTTP request | Description
1111
[**createCustomFileFromUpload**](PDFApi.md#createCustomFileFromUpload) | **POST** /custom_files | Create a new custom file from a cached presign upload
1212
[**createDataRequestToken**](PDFApi.md#createDataRequestToken) | **POST** /data_requests/{data_request_id}/tokens | Creates a new data request token for form authentication
1313
[**createFolder**](PDFApi.md#createFolder) | **POST** /folders/ | Create a folder
14-
[**createTemplate**](PDFApi.md#createTemplate) | **POST** /templates | Upload a new PDF template with a file upload
15-
[**createTemplateFromUpload**](PDFApi.md#createTemplateFromUpload) | **POST** /templates?v=2 | Create a new PDF template from a cached presign upload
14+
[**createHTMLTemplate**](PDFApi.md#createHTMLTemplate) | **POST** /templates?desc=html | Create a new HTML template
15+
[**createPDFTemplate**](PDFApi.md#createPDFTemplate) | **POST** /templates | Create a new PDF template with a form POST file upload
16+
[**createPDFTemplateFromUpload**](PDFApi.md#createPDFTemplateFromUpload) | **POST** /templates?desc=cached_upload | Create a new PDF template from a cached presign upload
1617
[**deleteFolder**](PDFApi.md#deleteFolder) | **DELETE** /folders/{folder_id} | Delete a folder
1718
[**expireCombinedSubmission**](PDFApi.md#expireCombinedSubmission) | **DELETE** /combined_submissions/{combined_submission_id} | Expire a combined submission
1819
[**expireSubmission**](PDFApi.md#expireSubmission) | **DELETE** /submissions/{submission_id} | Expire a PDF submission
@@ -31,6 +32,7 @@ Method | HTTP request | Description
3132
[**renameFolder**](PDFApi.md#renameFolder) | **POST** /folders/{folder_id}/rename | Rename a folder
3233
[**testAuthentication**](PDFApi.md#testAuthentication) | **GET** /authentication | Test Authentication
3334
[**updateDataRequest**](PDFApi.md#updateDataRequest) | **PUT** /data_requests/{data_request_id} | Update a submission data request
35+
[**updateTemplate**](PDFApi.md#updateTemplate) | **PUT** /templates/{template_id} | Update a Template
3436

3537

3638
# **batchGeneratePdfV1**
@@ -413,10 +415,64 @@ Name | Type | Description | Notes
413415

414416
[[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)
415417

416-
# **createTemplate**
417-
> \DocSpring\Model\PendingTemplate createTemplate($template_document, $template_name, $template_parent_folder_id)
418+
# **createHTMLTemplate**
419+
> \DocSpring\Model\PendingTemplate createHTMLTemplate($create_template_data1)
418420
419-
Upload a new PDF template with a file upload
421+
Create a new HTML template
422+
423+
### Example
424+
```php
425+
<?php
426+
require_once(__DIR__ . '/vendor/autoload.php');
427+
428+
// Configure HTTP basic authorization: api_token_basic
429+
$config = DocSpring\Configuration::getDefaultConfiguration()
430+
->setUsername('YOUR_USERNAME')
431+
->setPassword('YOUR_PASSWORD');
432+
433+
434+
$apiInstance = new DocSpring\Api\PDFApi(
435+
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
436+
// This is optional, `GuzzleHttp\Client` will be used as default.
437+
new GuzzleHttp\Client(),
438+
$config
439+
);
440+
$create_template_data1 = new \DocSpring\Model\CreateTemplateData1(); // \DocSpring\Model\CreateTemplateData1 |
441+
442+
try {
443+
$result = $apiInstance->createHTMLTemplate($create_template_data1);
444+
print_r($result);
445+
} catch (Exception $e) {
446+
echo 'Exception when calling PDFApi->createHTMLTemplate: ', $e->getMessage(), PHP_EOL;
447+
}
448+
?>
449+
```
450+
451+
### Parameters
452+
453+
Name | Type | Description | Notes
454+
------------- | ------------- | ------------- | -------------
455+
**create_template_data1** | [**\DocSpring\Model\CreateTemplateData1**](../Model/CreateTemplateData1.md)| |
456+
457+
### Return type
458+
459+
[**\DocSpring\Model\PendingTemplate**](../Model/PendingTemplate.md)
460+
461+
### Authorization
462+
463+
[api_token_basic](../../README.md#api_token_basic)
464+
465+
### HTTP request headers
466+
467+
- **Content-Type**: application/json
468+
- **Accept**: application/json
469+
470+
[[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)
471+
472+
# **createPDFTemplate**
473+
> \DocSpring\Model\PendingTemplate createPDFTemplate($template_document, $template_name, $template_parent_folder_id)
474+
475+
Create a new PDF template with a form POST file upload
420476

421477
### Example
422478
```php
@@ -440,10 +496,10 @@ $template_name = 'template_name_example'; // string |
440496
$template_parent_folder_id = 'template_parent_folder_id_example'; // string |
441497

442498
try {
443-
$result = $apiInstance->createTemplate($template_document, $template_name, $template_parent_folder_id);
499+
$result = $apiInstance->createPDFTemplate($template_document, $template_name, $template_parent_folder_id);
444500
print_r($result);
445501
} catch (Exception $e) {
446-
echo 'Exception when calling PDFApi->createTemplate: ', $e->getMessage(), PHP_EOL;
502+
echo 'Exception when calling PDFApi->createPDFTemplate: ', $e->getMessage(), PHP_EOL;
447503
}
448504
?>
449505
```
@@ -471,8 +527,8 @@ Name | Type | Description | Notes
471527

472528
[[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)
473529

474-
# **createTemplateFromUpload**
475-
> \DocSpring\Model\PendingTemplate createTemplateFromUpload($create_template_data)
530+
# **createPDFTemplateFromUpload**
531+
> \DocSpring\Model\PendingTemplate createPDFTemplateFromUpload($create_template_data)
476532
477533
Create a new PDF template from a cached presign upload
478534

@@ -496,10 +552,10 @@ $apiInstance = new DocSpring\Api\PDFApi(
496552
$create_template_data = new \DocSpring\Model\CreateTemplateData(); // \DocSpring\Model\CreateTemplateData |
497553

498554
try {
499-
$result = $apiInstance->createTemplateFromUpload($create_template_data);
555+
$result = $apiInstance->createPDFTemplateFromUpload($create_template_data);
500556
print_r($result);
501557
} catch (Exception $e) {
502-
echo 'Exception when calling PDFApi->createTemplateFromUpload: ', $e->getMessage(), PHP_EOL;
558+
echo 'Exception when calling PDFApi->createPDFTemplateFromUpload: ', $e->getMessage(), PHP_EOL;
503559
}
504560
?>
505561
```
@@ -1508,3 +1564,59 @@ Name | Type | Description | Notes
15081564

15091565
[[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)
15101566

1567+
# **updateTemplate**
1568+
> \DocSpring\Model\UpdateTemplateResponse updateTemplate($template_id, $update_template_data)
1569+
1570+
Update a Template
1571+
1572+
### Example
1573+
```php
1574+
<?php
1575+
require_once(__DIR__ . '/vendor/autoload.php');
1576+
1577+
// Configure HTTP basic authorization: api_token_basic
1578+
$config = DocSpring\Configuration::getDefaultConfiguration()
1579+
->setUsername('YOUR_USERNAME')
1580+
->setPassword('YOUR_PASSWORD');
1581+
1582+
1583+
$apiInstance = new DocSpring\Api\PDFApi(
1584+
// If you want use custom http client, pass your client which implements `GuzzleHttp\ClientInterface`.
1585+
// This is optional, `GuzzleHttp\Client` will be used as default.
1586+
new GuzzleHttp\Client(),
1587+
$config
1588+
);
1589+
$template_id = tpl_000000000000000003; // string |
1590+
$update_template_data = new \DocSpring\Model\UpdateTemplateData(); // \DocSpring\Model\UpdateTemplateData |
1591+
1592+
try {
1593+
$result = $apiInstance->updateTemplate($template_id, $update_template_data);
1594+
print_r($result);
1595+
} catch (Exception $e) {
1596+
echo 'Exception when calling PDFApi->updateTemplate: ', $e->getMessage(), PHP_EOL;
1597+
}
1598+
?>
1599+
```
1600+
1601+
### Parameters
1602+
1603+
Name | Type | Description | Notes
1604+
------------- | ------------- | ------------- | -------------
1605+
**template_id** | **string**| |
1606+
**update_template_data** | [**\DocSpring\Model\UpdateTemplateData**](../Model/UpdateTemplateData.md)| |
1607+
1608+
### Return type
1609+
1610+
[**\DocSpring\Model\UpdateTemplateResponse**](../Model/UpdateTemplateResponse.md)
1611+
1612+
### Authorization
1613+
1614+
[api_token_basic](../../README.md#api_token_basic)
1615+
1616+
### HTTP request headers
1617+
1618+
- **Content-Type**: application/json
1619+
- **Accept**: application/json
1620+
1621+
[[Back to top]](#) [[Back to API list]](../../README.md#documentation-for-api-endpoints) [[Back to Model list]](../../README.md#documentation-for-models) [[Back to README]](../../README.md)
1622+

docs/Model/CombinedSubmission.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ Name | Type | Description | Notes
77
**expired** | **bool** | | [optional]
88
**expires_at** | **string** | | [optional]
99
**source_pdfs** | **object[]** | | [optional]
10+
**pdf_hash** | **string** | | [optional]
1011
**download_url** | **string** | | [optional]
1112
**submission_ids** | **string[]** | | [optional]
1213
**id** | **string** | | [optional]

docs/Model/CreateTemplateData.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
## Properties
44
Name | Type | Description | Notes
55
------------ | ------------- | ------------- | -------------
6-
**template** | [**\DocSpring\Model\Templatesv2Template**](Templatesv2Template.md) | |
6+
**template** | [**\DocSpring\Model\TemplatesdesccachedUploadTemplate**](TemplatesdesccachedUploadTemplate.md) | |
77

88
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
99

docs/Model/CreateTemplateData1.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# CreateTemplateData1
2+
3+
## Properties
4+
Name | Type | Description | Notes
5+
------------ | ------------- | ------------- | -------------
6+
**template** | [**\DocSpring\Model\TemplatesdesccachedUploadTemplate**](TemplatesdesccachedUploadTemplate.md) | |
7+
8+
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
9+
10+

docs/Model/PendingTemplate.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Name | Type | Description | Notes
88
**parent_folder_id** | **string** | | [optional]
99
**expire_after** | **float** | | [optional]
1010
**allow_additional_properties** | **bool** | | [optional]
11+
**description** | **string** | | [optional]
1112
**public_submissions** | **bool** | | [optional]
1213
**slack_webhook_url** | **string** | | [optional]
1314
**path** | **string** | | [optional]

docs/Model/Submission.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ Name | Type | Description | Notes
1212
**processed_at** | **string** | | [optional]
1313
**state** | **string** | |
1414
**metadata** | **object** | | [optional]
15+
**pdf_hash** | **string** | | [optional]
1516
**download_url** | **string** | | [optional]
1617
**permanent_download_url** | **string** | | [optional]
1718
**batch_id** | **string** | | [optional]

docs/Model/SubmissionData.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Name | Type | Description | Notes
88
**html** | **string** | | [optional]
99
**css** | **string** | | [optional]
1010
**metadata** | **object** | | [optional]
11+
**field_overrides** | **object** | | [optional]
1112
**data_requests** | [**\DocSpring\Model\CreateSubmissionDataRequestData[]**](CreateSubmissionDataRequestData.md) | | [optional]
1213

1314
[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

0 commit comments

Comments
 (0)