CartoDB-SQL-API/docs/guides/02-authentication.md

18 lines
986 B
Markdown
Raw Normal View History

2018-02-22 02:11:51 +08:00
## Authentication
2019-06-12 22:40:56 +08:00
For all access to private tables, and for write access to public tables, CARTO enforces secure API access that requires you to authorize your queries. In order to authorize queries, you need to use an API Key.
2018-02-22 02:11:51 +08:00
### API Key
The API Key offers the simplest way to access private data, or perform writes and updates to your public data. Remember that your API Key protects access to your data, so keep it confidential and only share it if you want others to have this access. If necessary, you can reset your API Key from your CARTO dashboard.
2019-06-12 22:43:09 +08:00
**Tip:** For details about how to access, or reset, your API Key, see [the Auth API Documentation](https://carto.com/developers/auth-api/) details.
2018-02-22 02:11:51 +08:00
To use your API Key, pass it as a parameter in an URL call to the CARTO API. For example, to perform an insert into your table, you would use the following URL structure.
##### Example
```bash
https://{username}.carto.com/api/v2/sql?q={SQL statement}&api_key={api_key}
```