hap-apiv3-data

Operate Mingdao Cloud HAP application data via the HAP V3 API.

13|2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/mingdaocom/hap-skills --skill hap-apiv3-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hap-apiv3-data
Source: https://github.com/mingdaocom/hap-skills/tree/main/skills/api/hap-apiv3-data
Command: npx skills add https://github.com/mingdaocom/hap-skills --skill hap-apiv3-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps developers reliably connect to Mingdao Cloud HAP through the V3 API, avoiding authentication mistakes, invalid field values, ineffective filters, and inefficient record operations.

Core Features & Use Cases

  • Authentication Setup: Configure Appkey and Sign, PAT, or OAuth credentials, including extracting credentials from an existing HAP MCP configuration when available.
  • Data Operations: Create worksheets, query records, insert and update data, delete records, perform batch operations, and run pivot aggregations.
  • Field and Filter Guidance: Handle option keys, numeric filter values, relation row IDs, collaborators, departments, attachments, dates, and nested AND/OR filters correctly.
  • Performance and Reliability: Apply pagination, batching, relation-query optimization, workflow-trigger controls, error checks, and safeguards against N+1 requests.
  • Use Case: Build a HAP-backed frontend or custom view that authenticates securely, loads filtered customer records, updates statuses, and preserves the correct behavior of workflows and relation fields.

Quick Start

Ask the HAP V3 data skill to authenticate against your target application and query records using the required worksheet, fields, and filter conditions.

Frequently Asked Questions about hap-apiv3-data

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I authenticate with the HAP V3 API for data integration?

HAP V3 API authentication requires an Appkey and Sign, Personal Access Token (PAT), or OAuth credentials. You can extract these credentials from an existing HAP MCP configuration to securely connect and operate on application data.

What is the best way to filter records and query relation fields in HAP V3?

Filtering records and querying relation fields in HAP V3 requires correct field mappings, option keys, numeric filter values, and relation row IDs. You must structure nested AND/OR filters properly to ensure queries return accurate results without errors.

How do I prevent N+1 requests when querying HAP relation fields?

Prevent N+1 requests during HAP relation field queries by applying relation-query optimization, pagination, and batching. These techniques reduce redundant API calls and improve performance when loading related records in custom views or frontends.

Can I perform batch record operations and data migration using the HAP V3 API?

Yes, the HAP V3 API supports batch record operations and data migration by allowing you to insert, update, and delete records in batches. It includes safeguards against field-value and record-operation errors during synchronization.

Why does my HAP V3 API call fail to trigger workflows during record updates?

HAP V3 API workflow triggers fail when workflow-trigger settings are not configured correctly during record updates. You must apply specific trigger controls and error checks to preserve the intended workflow behavior while updating data.

Does the HAP V3 API support pivot aggregations for custom view plugins?

Yes, the HAP V3 API supports pivot aggregations for custom view plugins. You can run pivot analysis on worksheet records while applying proper pagination and filter structures to aggregate data reliably.