Mengakses LimeSurvey API dengan Python Citric

Kemarin kita telah mencoba menggunakan library limepy untuk mendapatkan data response survey. Sepengetahuan saya setelah mencobanya, limepy mempunyai method-method terbatas. Tidak ada cara bagaimana mengakses LimeSurvey API menggunakan library ini. Kelihatannya memang tidak ada. Dia hanya memanfaatkan sedikit LimeSurveyAPI untuk medukung fungsi-fungsi dia sendiri.

Tapi bukan Python namanya kalau berhenti disitu. Python itu surganya library. Kita mendapatkan library untuk memaksimalkan penggunaan LimeSurvey API: citric. Library ini bisa mengakses seluruh fungsi dalam Limesurvey. Nampaknya, ini mirip library limer  pada R.

Ok langsung saja …

Install Library Citric

Okey, cukup dengan pip install citric

Contoh menampilkan semua List Survey

from citric import Client

client = Client(
    "https://mylimesite.limequery.com/admin/remotecontrol",
    "myusername",
    "mypassword"
)

for survey in client.list_surveys():
    print(survey["surveyls_title"])

Contoh mengambil struktur pertanyaan menggunakan list_question

from citric import Client

# Connect to your LimeSurvey instance
client = Client(
    "https://mylimesite.limequery.com/admin/remotecontrol", 
    "myusername", 
    "mypassword"
)

# Choose a survey ID 
survey_id = 452848 

# List questions from the chosen survey
questions = client.list_questions(survey_id)

# Print the questions
for question in questions:
    print(f"Question ID: {question['qid']}, Question Text: {question['question']}")

Contoh mengambil data dalam format CSV

from citric import Client

client = Client(
    "https://mylimesite.limequery.com/admin/remotecontrol", 
    "myusername", 
    "mypassword"
)

survey_id = 452848  # Replace with your survey ID

export_response = client.save_responses(
    filename="responses.csv",
    survey_id=survey_id,
    file_format="csv",
    language=None,  # None will use the default language
    completion_status="all",  # all, incomplete, complete
    heading_type="code",  # code, abbreviated, full
    response_type="long",  # short, long
    from_response_id=None,  # None will export all responses
    to_response_id=None  # None will export all responses
)

print("Responses have been exported and saved to responses.csv")

Untuk dokumentasi citric, silahkan akses dimari …

Oke sedemikian dulu, nanti kita lanjutkan dengan kasus-kasus yang lebih implementatif. Enjoy …