The Tobacco, Alcohol, Prescription medication, and other Substance use (TAPS) Tool consists of a combined screening component (TAPS-1) followed by a brief assessment (TAPS-2) for those who screen positive.
The TAPS API does not have any parameters and will return all questions or summaries. As such, simply using the API endpoints is enough. To access the APIs you must have an API key. The API key must be passed as a header value assigned to the x-api-key
property.
You can register for an API key by completing the API Gateway Registration form.
For additional information, terms of use, and FAQs, please see our NIDA Screening Tool APIs: Overview for Developers page.
The endpoint is as follows: https://api.drugabuse.gov/taps/questions
Below is an example of the response from the endpoint.
{
questions: [
{
id: "20520",
title: "In the PAST YEAR, on how many days did you smoke cigarettes or use other tobacco products?",
description: "",
field_type: "slider",
answers: "365",
starting_question: "1",
drugs: "Tobacco",
dependencies: "",
hasSubs: "No",
risk_value: null
}
]
}
The endpoint is as follows: https://api.drugabuse.gov/taps/summaries
Below is an example of the response from the endpoints.
{
{
summary: [
{
title: "Tobacco",
riskLevel: "High",
description: "<p> Patients with this result are at high risk for adverse outcomes related to tobacco/nicotine product use and are likely to meet DSM V criteria for a Tobacco Use Disorder at a high severity level. </p>",
drug: "Tobacco",
toolType: "TAPS",
additionalResources: "<h3> Tobacco Use Resources </h3> <ul> <li> <a href="http://www.ncbi.nlm.nih.gov/books/NBK63952/" target="_blank">U.S. Department of Health & Human Services: Treating Tobacco Use and Dependence: 2008 Update</a> </li> <li> <a href="https://innovations.ahrq.gov/qualitytools/helping-smokers-quit-guide-clinicians">Agency for Healthcare Research and Quality: Helping Smokers Quit: A Guide for Clinicians</a> </li> </ul> <h3> General Resources </h3> <ul> <li> <a href="/sites/default/files/sbirt_training_manual_2012_100719_284_13471_v3.pdf">Yale School of Medicine: Screening, Brief Intervention & Referral to Treatment Training Manual</a> </li> <li> <a href="/blending-initiative/cme-ce-simulation">NIDA: Motivational Interviewing Skills Practice</a> </li> <li> <a href="/sites/default/files/oarsessentialcommunicationtechniques.pdf">Center for Health Training: OARS Essential Communication Techniques</a> </li> </ul> ",
suggestedAction: "<p> The suggested intervention for this group is further assessment, and treatment for those who are found to have a tobacco use disorder. </p> <ol> <li> Assess further through a clinical interview. <ul> <li> Questions from the Fagerstrom Test for Nicotine Dependence or DSM-5 can be used as a guide. </li> </ul> </li> <li> Express concern and recommend cessation. <ul> <li> Use the <a href="http://www.who.int/substance_abuse/activities/en/Draft_Brief_Intervention_for_Substance_Use.pdf#page=12">FRAMES</a> components and <u><a href="/blending-initiative/cme-ce-simulation">motivational interviewing techniques</a></u> (see references for specific resources) to encourage engagement in treatment. </li> </ul> </li> <li> Make a specific plan, including strategies for reducing health consequences of tobacco use. </li> <li> Consider prescribing medications to treat tobacco dependence (nicotine replacement, bupropion SR, varenicline). </li> <li> Offer a referral to support groups or counseling for tobacco cessation. </li> <li> Arrange follow-up. </li> </ol> "
}
}
First please consider going through the tool that exist at https://www.drugabuse.gov/taps
Going through this tool will give a general idea of how the two api parts should work together. In short:
In general, your application will need to make a call to get the all the questions and handle the logic to proceed through the questions. The logic for the questions is handled via the dependency field on each question.
Each question has a dependency. This is how the application knows what question to display. The dependencies are based on the id of the parent question or questions and how they were answered. So if a question has a value of 20520|!0
, that means that if the question with the id of 20520 had an answer that was not 0, this question should be displayed. Multiple dependencies are separated by commas.
Risk Levels are used to display the correct summary result information. In TAPS, the risk level is assessed based on the score of each drug. The score is assessed based on the answer to each question. Values are included with each questions. There are four risk levels minimal, low, moderate, and high as it pertains to the tool and the risk levels are specific to each drug. The study this is based on has three risk levels, but the tool handles risk levels a specific way to meet the study's process