Plugin REST API Endpoints

The KiviCare Google Meet Addon provides a set of REST API endpoints that manage authentication, configuration, and Google Meet consultation workflows. These endpoints enable secure communication between WordPress, KiviCare, and Google services.

Base API URL

All endpoints are relative to the following base path:

YOUR_SITE_URL/wp-json/kivi-care/v1/

Administrator Endpoints

These endpoints are accessible only to Administrators and are used to manage global Google Meet configuration.

1. Retrieve Global Settings

• Endpoint: settings/googlemeet
• Method: GET
• Authorization: Administrator
• Description: Returns the global Google Meet configuration, event template data, and the authorized redirect URI required for OAuth setup.

2. Update Global Settings

• Endpoint: settings/googlemeet
• Method: POST / PUT
• Authorization: Administrator
• Description: Saves or updates the global Google Meet credentials and event template configuration.
• Payload Example:

{
  "google_meet_config": {
    "client_id": "...",
    "client_secret": "..."
  },
  "google_meet_event_template": { }
}

Doctor Endpoints

These endpoints allow doctors to manage their individual Google Meet connections.

1. Get Doctor Configuration

• Endpoint: settings/googlemeet/doctor-config
• Method: GET
• Authorization: Doctor
• Description: Returns the doctor’s current Google Meet connection status and authentication configuration.

2. Update Doctor Configuration

• Endpoint: settings/googlemeet/doctor-config
• Method: PUT
• Authorization: Doctor
• Description: Updates the doctor’s Google Meet authentication settings.
• Payload Example:

{
  "auth_type": "oauth",
  "client_id": "...",
  "client_secret": "..."
}

3. Generate Authorization URL

• Endpoint: settings/googlemeet/authorize
• Method: GET
• Authorization: Doctor
• Description: Returns the Google OAuth authorization URL.
• Response Example:

{
  "redirect_url": "https://accounts.google.com/..."
}

4. Disconnect Google Account

• Endpoint: settings/googlemeet/disconnect
• Method: GET
• Authorization: Doctor
• Description: Revokes the existing Google Meet connection for the doctor.

5. Test Google Meet Connection

• Endpoint: settings/googlemeet/test-connection
• Method: PUT
• Authorization: Doctor
• Description: Verifies the validity of the doctor’s Google Meet connection and credentials.

Public Callback Endpoint

OAuth Authorization Callback

• Endpoint: settings/googlemeet/callback
• Method: GET
• Access: Public (secured via OAuth state validation)
• Purpose:
  Receives the authorization code and state from Google, exchanges them for access and refresh tokens, and redirects the user back to the KiviCare dashboard.