FAQ Management API The FAQ API allows you to manage frequently asked questions organized by categories. FAQs can be scoped to specific user roles (guide, tourist, or both).
FAQ Categories Get All FAQ Categories curl -X GET https://api.kinconecta.com/api/faq-categories \ -H "Content-Type: application/json"
Response Unique identifier for the FAQ category
Category name (max 120 characters)
Target audience for this category
guide - Only for tour guidestourist - Only for touristsboth - For all users (default) Display order (default: 0)
[ { "id" : 1 , "name" : "Getting Started" , "roleScope" : "both" , "sortOrder" : 0 }, { "id" : 2 , "name" : "Tour Guide Information" , "roleScope" : "guide" , "sortOrder" : 1 } ]
Get FAQ Category by ID curl -X GET https://api.kinconecta.com/api/faq-categories/{id} \ -H "Content-Type: application/json"
Path Parameters Response Returns a single FAQ category object or 404 if not found.
{ "id" : 1 , "name" : "Getting Started" , "roleScope" : "both" , "sortOrder" : 0 }
Create FAQ Category curl -X POST https://api.kinconecta.com/api/faq-categories \ -H "Content-Type: application/json" \ -d '{ "name": "Booking Questions", "roleScope": "tourist", "sortOrder": 2 }'
Request Body Category name (max 120 characters)
Target audience: guide, tourist, or both
Response Returns the created FAQ category object.
Update FAQ Category curl -X PUT https://api.kinconecta.com/api/faq-categories/{id} \ -H "Content-Type: application/json" \ -d '{ "name": "Updated Category Name", "roleScope": "both", "sortOrder": 1 }'
Path Parameters The FAQ category ID to update
Request Body Response Returns the updated FAQ category object or 404 if not found.
Delete FAQ Category curl -X DELETE https://api.kinconecta.com/api/faq-categories/{id} \ -H "Content-Type: application/json"
Path Parameters The FAQ category ID to delete
Response Returns 204 No Content on success.
FAQ Items Get All FAQ Items curl -X GET https://api.kinconecta.com/api/faq-items \ -H "Content-Type: application/json"
Response Unique identifier for the FAQ item
The FAQ question (max 300 characters)
The FAQ answer (text field)
Whether the FAQ item is active (default: true)
Display order within category (default: 0)
[ { "id" : 1 , "faqCategoryId" : 1 , "question" : "How do I create an account?" , "answer" : "To create an account, click on the Sign Up button and fill in your details..." , "isActive" : true , "sortOrder" : 0 }, { "id" : 2 , "faqCategoryId" : 1 , "question" : "How do I reset my password?" , "answer" : "Click on the Forgot Password link on the login page..." , "isActive" : true , "sortOrder" : 1 } ]
Get FAQ Item by ID curl -X GET https://api.kinconecta.com/api/faq-items/{id} \ -H "Content-Type: application/json"
Path Parameters Response Returns a single FAQ item object or 404 if not found.
Create FAQ Item curl -X POST https://api.kinconecta.com/api/faq-items \ -H "Content-Type: application/json" \ -d '{ "faqCategoryId": 1, "question": "How do I book a tour?", "answer": "Browse available tours, select one, and click the Book Now button...", "isActive": true, "sortOrder": 3 }'
Request Body The category this FAQ belongs to
The FAQ question (max 300 characters)
The FAQ answer (text field)
Whether the FAQ is active
Display order within category
Response Returns the created FAQ item object.
Update FAQ Item curl -X PUT https://api.kinconecta.com/api/faq-items/{id} \ -H "Content-Type: application/json" \ -d '{ "faqCategoryId": 1, "question": "Updated question?", "answer": "Updated answer...", "isActive": false, "sortOrder": 5 }'
Path Parameters The FAQ item ID to update
Request Body All fields from the create request.
Response Returns the updated FAQ item object or 404 if not found.
Delete FAQ Item curl -X DELETE https://api.kinconecta.com/api/faq-items/{id} \ -H "Content-Type: application/json"
Path Parameters The FAQ item ID to delete
Response Returns 204 No Content on success.