Have a question that you don’t see answered here? We strive to make our docs as self-explanatory as possible and we’re always looking for ways to improve. Give us a shout with your feedback and questions.
General
What is the Stitch Import API?
The Stitch Import API (or just Import API) provides a simple way for our customers to get data from various sources into the Stitch app. Once the data enters the Import API, it will be processed by the app just like the data from any other integration.
What do I need to use the Import API?
You need a Stitch account to use the Import API. If you don’t already have an account, you can create one for free.
Who should use the Import API? Who shouldn’t?
Using the Import API requires a certain level of technical expertise. Someone comfortable writing and maintaining a small Ruby or PHP script will be more than qualified.
If the data in question is already in a database or SaaS integration we already support, it is often easier to to use the native integration. However, you can always use the Import API if you want total control over data replication.
What type of data can I send?
You can send data from any source as long as it’s in either JSON or Transit formats once it gets to us. We send data to the Import API for systems monitoring, syncing data from Google Drive, anda variety of other purposes.
For any data sources for which we don’t yet have a direct, native integration, the Import API will be your best bet. You can see the full list of current integrations here.
Troubleshooting
I’m getting a 4xx error code, what do I do?
Check out the return code from your request and double-check your request’s validity.
I’m getting a 5xx error code, what do I do?
Try your request again. Additionally, we recommend checking our status page for reported outages if you receive a code in this range. If nothing has been reported and these errors persist, please reach out to our support team.
Security
How secure is the API?
We store all of your data in a private cloud and only connect via SSH. Each API key is totally independent of every other key and can only push data. This means if somebody gets their hands on your key, they won’t be able to access your data.
Despite the security of the API, DO NOT push sensitive data - such as credit cards or medical records - to the Import API.
Is the Import API compliant with PCI and/or HIPPA?
Stitch is PCI Level 4 compliant.
Stitch is not HIPPA compliant.
Despite our PCI compliance, please do not push sensitive information to the Import API.
What happens if my API key is compromised?
Luckily, nobody can access data with your API key: they can only send it. If your key has been compromised, you can revoke it in the Integration Settings page.
I don’t see my security question here.
Check out the Security FAQ for more general security info. Please reach out to us if you still have questions.
| Related | Troubleshooting |
|
|
Questions? Feedback?
Did this article help? If you have questions or feedback, please reach out to us.