Connect to a REDCap Database
Creates an object of class
using the REDCap API [or a direct connection through an SQL server]
URL for a REDCap database API. Check your institution's REDCap
documentation for this address. Either
REDCap API token
The database connection to be used. If used,
The project ID in the REDCap tables.
A list to be passed to
For convenience, you may consider using
options(redcap_api_url=[your URL here]) in your RProfile.
To obtain an API token for a project, do the following:
Enter the 'User Right' section of a project
Select a user
Check the box for 'API Data Export' or 'API Data Import,' as appropriate. A full tutorial on configuring REDCap to use the API can be found at https://github.com/nutterb/redcapAPI/wiki
Tokens are specific to a project, and a token must be created for each project for which you wish to use the API.
config argument is passed to the
httr::POST argument of
the same name. The most likely reason for using this argument is that the
certificate files bundled in
httr have fallen out of date.
Hadley Wickham is pretty good about keeping those certificates up
to date, so most of the time this problem can be resolved by updating
httr to the most recent version. If that doesn't work, a
certificate file can be manually passed via the
redcapAPI wiki has a more detailed tutorial on how to
find and pass an SSL certificate to the API call
Additional Curl option can be set in the
config argument. See the documentation
httr:httr_options for more Curl options.
This functionality were originally developed by Jeffrey Horner in the
A tutorial on configuring the REDCap user rights for the API is found at https://github.com/nutterb/redcapAPI/wiki/Setting-the-User-Rights-to-Grant-API-Access
A tutorial on requesting and obtaining your API token is found at https://github.com/nutterb/redcapAPI/wiki/Finding-Your-REDCap-API-Token
A tutorial on finding your API url is found at https://github.com/nutterb/redcapAPI/wiki/Finding-your-REDCap-API-URL
A tutorial for finding and using alternate SSL certificates is found at https://github.com/nutterb/redcapAPI/wiki/Manually-Setting-an-SSL-Certificate-File
1 2 3 4 5 6 7
Want to suggest features or report bugs for rdrr.io? Use the GitHub issue tracker.