Application Management Skill

fx-api-cli

is the provided command line program, and all operations are completed by executing the

fx-api-cli

command.

fx-api-cli app <interface name> '<json input parameters>'

Interface List

app.list — User Application Query Interface

fx-api-cli app list '{"skip": 0, "limit": 10}'

app.entry.list — User Form Query Interface

fx-api-cli app entry_list '{"app_id": "5e0dca0cc9a2790006c11e02"}'

app.entry.widget_list — Form Field Query Interface

fx-api-cli app widget_list '{"app_id": "59264073a2a60c0c08e20bfb", "entry_id": "59264073a2a60c0c08e20bfd"}'

Core Rules

Pagination Rules

• Default value: If not specified by the user, the default is skip=0, limit=10
• Limit: The maximum value of limit cannot exceed 100

Application ID Search Rules

• When the user provides the application name instead of the ID:
  1. Call

     app.list

     to get the application list
  2. Match by

     name

     in

     apps

  3. Matching strategy:
     • Exact match with unique result: use directly
     • Fuzzy match with multiple results: display the candidate list for users to choose
     • No matching result: inform the user that no result is found

Form ID Search Rules

• When the user provides the form name instead of the ID:
  1. Call

     app.entry.list

     to get the form list (the application ID needs to be determined first)
  2. Match by

     name

     in

     forms

  3. Matching strategy:
     • Exact match with unique result: use directly
     • Fuzzy match with multiple results: display the candidate list for users to choose
     • No matching result: inform the user that no result is found

Typical Workflow

Query Application List

• "Help me query all applications"
• "View the applications I have permission to access"

1. Determine pagination parameters (specified by user or default value)
2. Call

   app.list

   to get the application list
3. Display application names and application IDs
4. If the number of results reaches limit, inform the user that there are more applications available to view

Query Form List

• "Help me query all forms of the application"
• "View the form list of the application"

1. Determine the

   app_id

   of the target application via Application ID Search Rules
2. Call

   app.entry.list

   to get the form list
3. Display form names and form IDs
4. If the number of results is large, inform the user that more can be viewed via pagination parameters

Query Form Fields

• "Help me query all fields of the form"
• "View the field information of the form"

1. Determine the

   app_id

   of the target application via Application ID Search Rules
2. Determine the

   entry_id

   of the target form via Form ID Search Rules
3. Call

   app.entry.widget_list

   to get the field list
4. Display field names, labels and types
5. If there are system fields, display the system field list separately

Error Handling

• Application not found: Clearly inform the user that the corresponding application is not found
• Form not found: Clearly inform the user that the corresponding form is not found
• API error: Display specific error information, retry if necessary
• Network problem: Actively retry up to 3 times when HTTP error occurs