https://github.com/rapidsurveys/okapi
Open Data Kit (ODK)-based Computer-assisted Personal Interview (CAPI) Tools
https://github.com/rapidsurveys/okapi
capi kobotoolbox odk ona r
Last synced: 5 months ago
JSON representation
Open Data Kit (ODK)-based Computer-assisted Personal Interview (CAPI) Tools
- Host: GitHub
- URL: https://github.com/rapidsurveys/okapi
- Owner: rapidsurveys
- License: gpl-3.0
- Created: 2019-09-07T04:21:05.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2025-01-03T02:17:50.000Z (5 months ago)
- Last Synced: 2025-01-03T03:23:32.799Z (5 months ago)
- Topics: capi, kobotoolbox, odk, ona, r
- Language: R
- Homepage: https://rapidsurveys.io/okapi/
- Size: 8.34 MB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 15
-
Metadata Files:
- Readme: README.Rmd
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: .github/CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
---
output: github_document
---
```{r, include = FALSE}
knitr::opts_chunk$set(
collapse = TRUE,
comment = "#>",
fig.path = "man/figures/README-",
out.width = "100%"
)
```
# okapi: Open Data Kit (ODK)-based Computer-assisted Personal Interview (CAPI) Tools 
[](https://www.repostatus.org/#active)
[](https://www.tidyverse.org/lifecycle/#experimental)
[](https://github.com/rapidsurveys/okapi/actions/workflows/R-CMD-check.yaml)
[](https://github.com/rapidsurveys/okapi/actions)
[](https://codecov.io/gh/rapidsurveys/okapi?branch=main)
[](https://www.codefactor.io/repository/github/rapidsurveys/okapi)
[](https://zenodo.org/badge/latestdoi/206914853)
Data collection using computer-assisted personal interviewing (CAPI) tools is now the standard approach for conducting surveys and studies. A wide range of CAPI systems are currently being used. The ability to interface with these systems helps in the overall data process. This package provides interface functions to CAPI systems based on the [Open Data Kit (ODK)](https://getodk.org) technology.
## What does the package do?
Currently, `{okapi}` provides functions to interface with [ONA](https://getodk.org) via its [API](https://api.ona.io/static/docs/index.html). The current set of functions perform the following tasks:
1. Authenticate with the respective servers using either an account password or an API token;
2. List resources in the server available to interface with; and,
3. Get data or resources from the server to [R](https://cran.r-project.org).
## Installation
`{okapi}` is not yet on [CRAN](https://cran.r-project.org) but can be installed from the [RapidSurveys R Universe](https://rapidsurveys.r-universe.dev) with:
```{r install, echo = TRUE, eval = FALSE}
install.packages(
"okapi",
repos = c(
'https://rapidsurveys.r-universe.dev', 'https://cloud.r-project.org'
)
)
```
## Usage
### Authentication
### List resources
### Retrieve resources
## Citation
If you use `{okapi}` in your work, please cite using the suggested citation provided by a call to the `citation` function as follows:
```{r cite}
citation("okapi")
```
## Community guidelines
Feedback, bug reports and feature requests are welcome; file issues or seek support [here](https://github.com/rapidsurveys/okapi/issues). If you would like to contribute to the package, please see our [contributing guidelines](https://rapidsurveys.io/okapi/CONTRIBUTING.html).
This project is released with a [Contributor Code of Conduct](https://rapidsurveys.io/okapi/CODE_OF_CONDUCT.html). By participating in this project you agree to abide by its terms.