6b502d8c32
* fixed test which check incorrect cred config
* Added oauth2 authentication
* Added oauth creds
* fixed formatting
* added oauth2 spec section, added missing type hints
* Added java part of Square OAuth
* fixed checkstyle
* removed commented code
* added support for old format of spec.json files, updated change logs docs
* renamed spec property 'authentication' to default 'credentials'. fixed changes in java part
* recovered empty files
* updated OAuthImplementationFactory.java
* fixed issue with autheticator for sub streams, added config catalog with all streams, updated docs
* use advanced_auth
* added advanced_auth
* moved scopes to private property
* updated source version
* Revert "updated source version"
This reverts commit ce3d06165c.
* updated source version
* added new version for airbyte index
Co-authored-by: ievgeniit <etsybaev@gmail.com>
4.0 KiB
4.0 KiB
Square
Overview
The Square Source can sync data from the Square API
Useful links:
Output schema
This Source is capable of syncing the following Streams:
- Items (Incremental)
- Categories (Incremental)
- Discounts (Incremental)
- Taxes (Incremental)
- ModifierLists (Incremental)
- Payments (Incremental)
- Refunds (Incremental)
- Locations
- Team Members (old V1 Employees API)
- List Team Member Wages (old V1 Roles API)
- Customers
- Shifts
- Orders
Data type mapping
| Integration Type | Airbyte Type | Notes |
|---|---|---|
string |
string |
|
integer |
integer |
|
array |
array |
|
object |
object |
|
boolean |
boolean |
Features
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental - Append Sync | Yes |
| Namespaces | No |
Requirements
- api_key - The Square API key token
- is_sandbox - the switch between sandbox (true) and production (false) environments
Setup guide
To get the API key for your square application follow Geting started and Access token guides
Performance considerations
No defined API rate limits were found in Square documentation however considering this information it has 10 QPS limits. The connector doesn't handle rate limits exceptions, but no errors were raised during testing.
Some Square API endpoints has different page size limitation
- Items - 1000
- Categories - 1000
- Discounts - 1000
- Taxes - 1000
- ModifierLists - 1000
- Payments - 100
- Refunds - 100
- TeamMembers - 100
- ListTeamMemberWages - 200
- Shifts - 200
- Orders - 500
Changelog
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 0.1.4 | 2021-12-02 | 6842 | Added oauth support |
| 0.1.3 | 2021-12-06 | 8425 | Update title, description fields in spec |
| 0.1.2 | 2021-11-08 | 7499 | Remove base-python dependencies |
| 0.1.1 | 2021-07-09 | 4645 | Update _send_request method due to Airbyte CDK changes |
| 0.1.0 | 2021-06-30 | 4439 | Initial release supporting the Square API |