CaPPr Drives API

This document describes how to use the CaPPr Drives API. For general information about how to use the API, please consult the general API documentation.

Account

Get account information.

Method

GET

URL

/account

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -X GET https://api.cappr.org/account

Response codes

Response properties

title (string)

Account title.

language (string)

Account language.

email (boolean)

Shows if email address needs to be provided when creating a session.

password (boolean)

Shows if password needs to be provided when creating a session.

subject (boolean)

Shows if subject needs to be provided when creating a session.

position (boolean)

false for Drives accounts.

test (boolean)

false for Drives accounts.

report (string)

Account report type.

set (object)

Set (flow) information.

positions (array)

null for Drives accounts.

Example responses

200

{
    "title": "Account",
    "language": "en",
    "email": true,
    "password": false,
    "subject": false,
    "position": false,
    "test": true,
    "report": "score",
    "set": {
        "description": "Drives",
        "algorithm": "drives",
        "polarity": "unipolar",
        "image": true,
        "caption": true
    },
    "positions": null
}

Session

Create a session.

Method

POST

URL

/session

Data parameters

email (string)

User email address. Only needed when account response email value is true.

password (string)

Password. Only needed when account response password value is true.

subject (string)

Desciption of object. Only needed when account response subject value is true.

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -F "email=info@company.com"
    -X POST https://api.cappr.org/session

Response codes

Response properties

uid (string)

Session UID.

email (string)

Stored email address.

errors (array)

List of errors, can contain:

Example responses

200

{
    "uid": "a99QIOYlv4pqcQwI",
    "email": "info@company.com"
}

406

{
    "errors": [
        "EMAIL_INCORRECT"
    ]
}

Question

Get the current question or generate a new one.

Method

GET

URL

/session/:uid/question

URL parameters

uid (string, required)

Session UID.

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -X GET https://api.cappr.org/session/a99QIOYlv4pqcQwI/question

Response codes

Response properties

id (int)

Question ID.

progress (int)

Contains completion percentage.

done (boolean)

Indicates if flow is done.

cards (array)

Collection of cards. bipolar sets contain two cards, unipolar sets only one. Questions can contain an image and/or a caption property. To determine if your current set has one or more of these fields consult the set information in the account response.

Example responses

200

{
    "id": 1,
    "progress": 0,
    "done": false,
    "cards": [
        {
            "id": 1,
            "display": {
                "image": "https://ftp.cappr.org/cards/1.jpg",
                "caption": "Lorem ipsum"
            }
        }
    ]
}

Answer

Answer a question.

Method

POST

URL

/session/:uid/answer

URL parameters

uid (string, required)

Session UID.

Data parameters

question_id (int, required)

ID of question to be answered.

answer (int, required)

Answer for the current question. Must be 0 (no) or 1 (yes).

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -F "question_id=1"
    -F "answer=1"
    -X POST https://api.cappr.org/session/a99QIOYlv4pqcQwI/answer

Response codes

Response properties

question_id (int)

Given question ID.

answer (int)

Given answer.

Example responses

200

{
    "question_id": 1,
    "answer": "1"
}

Report

Get the flow outcome report. To determine your report type consult the account response.

Method

GET

URL

/session/:uid/report

URL parameters

uid (string, required)

Session UID.

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -X GET https://api.cappr.org/session/a99QIOYlv4pqcQwI/report

Response codes

Response properties

Report responses differ per report type and are mostly self explanatory.

Example responses

200

[
    "green",
    "red",
    "purple",
    "yellow",
    "orange",
    "blue"
]

Match

Calculate the match between session and input.

Method

GET

URL

`/session/:uid/match?1=:color&2=:color&3=:color

URL parameters

color (string, required)

The request needs the three strongest Drives colors.

Example request

curl
    -H "Content-Type: multipart/form-data"
    -H "Authorization: Basic ZnJlZDpmcmVk"
    -X GET https://api.cappr.org/session/a99QIOYlv4pqcQwI/match?1=green&2=red&3=purple

Response codes

Response properties

session (object)

Session score.

input (object)

Input score.

match (int)

Match percentage.

Example responses

200

{
    "session": [
        "green",
        "red",
        "purple",
        "yellow",
        "orange",
        "blue"
    ],
    "input": [
        "purple",
        "red",
        "purple"
    ],
    "match": 50
}