87 lines
5.0 KiB
Markdown
87 lines
5.0 KiB
Markdown
# Pocket
|
|
|
|
## Overview
|
|
|
|
The Pocket source connector only supports full refresh syncs
|
|
|
|
### Output schema
|
|
|
|
A single output stream is available from this source:
|
|
|
|
- [Retrieve](https://getpocket.com/developer/docs/v3/retrieve)
|
|
|
|
### Features
|
|
|
|
| Feature | Supported? |
|
|
| :---------------- | :--------- |
|
|
| Full Refresh Sync | Yes |
|
|
| Incremental Sync | No |
|
|
|
|
### Performance considerations
|
|
|
|
For more info on rate limiting, please refer to [Pocket Docs > Rate Limits](https://getpocket.com/developer/docs/rate-limits)
|
|
|
|
## Getting started
|
|
|
|
### Requirements
|
|
|
|
- Consumer Key
|
|
- Access Token
|
|
|
|
### Setup Guide
|
|
|
|
In order to obtain the Consumer Key and Access Token, please follow the official [Pocket Authentication docs](https://getpocket.com/developer/docs/authentication).
|
|
|
|
It's nevertheless, very recommended to follow [this guide](https://www.jamesfmackenzie.com/getting-started-with-the-pocket-developer-api/) by James Mackenzie, which is summarized below:
|
|
|
|
1. Create an App in the [Pocket Developer Portal](https://getpocket.com/developer/apps/new), give it Retrieve permissions and get your Consumer Key.
|
|
2. Obtain a Request Token. To do so, you need to issue a POST request to get a temporary Request Token. You can execute the command below:
|
|
|
|
```sh
|
|
curl --insecure -X POST -H 'Content-Type: application/json' -H 'X-Accept: application/json' \
|
|
https://getpocket.com/v3/oauth/request -d '{"consumer_key":"REPLACE-ME","redirect_uri":"http://www.google.com"}'
|
|
```
|
|
|
|
3. Visit the following website from your browser, and authorize the app: `https://getpocket.com/auth/authorize?request_token=REPLACE-ME&redirect_uri=http://www.google.com`
|
|
4. Convert your Request Token Into a Pocket Access Token. To do so, you can execute the following command:
|
|
|
|
```sh
|
|
curl --insecure -X POST -H 'Content-Type: application/json' -H 'X-Accept: application/json' \
|
|
https://getpocket.com/v3/oauth/authorize -d '{"consumer_key":"REPLACE-ME","code":"REQUEST-TOKEN"}'
|
|
```
|
|
|
|
## Changelog
|
|
|
|
<details>
|
|
<summary>Expand to review</summary>
|
|
|
|
| Version | Date | Pull Request | Subject |
|
|
| :------ | :--------- | :------------------------------------------------------- | :------------------------------------------------------------------------------ |
|
|
| 0.2.2 | 2024-12-12 | [47783](https://github.com/airbytehq/airbyte/pull/47783) | Update dependencies |
|
|
| 0.2.1 | 2024-10-28 | [47034](https://github.com/airbytehq/airbyte/pull/47034) | Update dependencies |
|
|
| 0.2.0 | 2024-10-21 | [47143](https://github.com/airbytehq/airbyte/pull/47143) | Migrate to manifest only format |
|
|
| 0.1.21 | 2024-10-12 | [46838](https://github.com/airbytehq/airbyte/pull/46838) | Update dependencies |
|
|
| 0.1.20 | 2024-10-05 | [46404](https://github.com/airbytehq/airbyte/pull/46404) | Update dependencies |
|
|
| 0.1.19 | 2024-09-28 | [46138](https://github.com/airbytehq/airbyte/pull/46138) | Update dependencies |
|
|
| 0.1.18 | 2024-09-21 | [45736](https://github.com/airbytehq/airbyte/pull/45736) | Update dependencies |
|
|
| 0.1.17 | 2024-09-14 | [45487](https://github.com/airbytehq/airbyte/pull/45487) | Update dependencies |
|
|
| 0.1.16 | 2024-09-07 | [45225](https://github.com/airbytehq/airbyte/pull/45225) | Update dependencies |
|
|
| 0.1.15 | 2024-08-31 | [44994](https://github.com/airbytehq/airbyte/pull/44994) | Update dependencies |
|
|
| 0.1.14 | 2024-08-24 | [44321](https://github.com/airbytehq/airbyte/pull/44321) | Update dependencies |
|
|
| 0.1.13 | 2024-08-10 | [43116](https://github.com/airbytehq/airbyte/pull/43116) | Update dependencies |
|
|
| 0.1.12 | 2024-07-27 | [42775](https://github.com/airbytehq/airbyte/pull/42775) | Update dependencies |
|
|
| 0.1.11 | 2024-07-20 | [42385](https://github.com/airbytehq/airbyte/pull/42385) | Update dependencies |
|
|
| 0.1.10 | 2024-07-13 | [41923](https://github.com/airbytehq/airbyte/pull/41923) | Update dependencies |
|
|
| 0.1.9 | 2024-07-10 | [41457](https://github.com/airbytehq/airbyte/pull/41457) | Update dependencies |
|
|
| 0.1.8 | 2024-07-09 | [41294](https://github.com/airbytehq/airbyte/pull/41294) | Update dependencies |
|
|
| 0.1.7 | 2024-07-06 | [41001](https://github.com/airbytehq/airbyte/pull/41001) | Update dependencies |
|
|
| 0.1.6 | 2024-06-25 | [40308](https://github.com/airbytehq/airbyte/pull/40308) | Update dependencies |
|
|
| 0.1.5 | 2024-06-22 | [39957](https://github.com/airbytehq/airbyte/pull/39957) | Update dependencies |
|
|
| 0.1.4 | 2024-06-06 | [39298](https://github.com/airbytehq/airbyte/pull/39298) | [autopull] Upgrade base image to v1.2.2 |
|
|
| 0.1.3 | 2024-04-19 | [37228](https://github.com/airbytehq/airbyte/pull/37228) | Upgrade to CDK 0.80.0 and manage dependencies with Poetry. |
|
|
| 0.1.2 | 2024-04-15 | [37228](https://github.com/airbytehq/airbyte/pull/37228) | Base image migration: remove Dockerfile and use the python-connector-base image |
|
|
| 0.1.1 | 2024-04-12 | [37228](https://github.com/airbytehq/airbyte/pull/37228) | schema descriptions |
|
|
| 0.1.0 | 2022-10-30 | [18655](https://github.com/airbytehq/airbyte/pull/18655) | 🎉 New Source: Pocket |
|
|
|
|
</details>
|