Synonyms interface

1. Add a synonym interface

request method

  • Request method: POST
  • Request URL: /v1/ctai/add_ctai_synonym
  • Content-Type: application/json

request parameters

{
    "ctai_synonym_entity": {
        "ctai_entity": {
            "content": "potatoes"
        },
        "ctai_synonym_list": [
            {
                "content": "potatoes"
            },
            {
                "content": "Potato"
            },
            {
                "content": "Potato"
            }
        ]
    }
}
parameterEnterprise TyperequiredParameter Description
ctai_synonym_entityobjectYesQ&A Intervention Information Object
ctai_entityobjectYesentity word information object
ctai_synonym_listarrayYessynonym list
contentstringYesEntity word or synonym content

Response business parameters

{
    "ctsynonym_id": "test_id"
}
parameterEnterprise TypeParameter Description
ctsynonym_idstringAdded entity word id


2. Modify the synonym interface

request method

  • Request method: POST
  • Request URL: /v1/ctai/modify_ctai_synonym
  • Content-Type: application/json

request parameters

{
    "ctsynonym_id": "test_id",
    "ctai_synonym_entity": {
        "ctai_entity": {
            "content": "potato"
        },
        "ctai_synonym_list": [
            {
                "content": "potato"
            },
            {
                "content": "Potato"
            },
            {
                "content": "Potato"
            }
        ]
    }
}
parameterEnterprise TyperequiredParameter Description
ctsynonym_idstringYesEntity word id
ctai_synonym_entityobjectYesQ&A Intervention Information Object
ctai_entityobjectYesentity word information object
ctai_synonym_listarrayYessynonym list
contentstringYesEntity word or synonym content

Response business parameters

  • No response service parameters


3. Delete the synonym interface

request method

  • Request method: POST
  • Request URL: /v1/ctai/delete_ctai_synonym
  • Content-Type: application/json

request parameters

{
    "ctsynonym_id": "test_id"
}
parameterEnterprise TyperequiredParameter Description
ctsynonym_idstringYesEntity word id, only one entity word can be deleted at a time

Response business parameters

  • No response service parameters


4. Synonym information interface

request method

  • Request method: POST
  • Request URL: /v1/ctai/ctai_synonym_info
  • Content-Type: application/json

request parameters

{
    "ctsynonym_id": "test"
}
parameterEnterprise TyperequiredParameter Description
ctsynonym_idstringYesEntity word id

Response business parameters

{
    "ctsynonym_id": "test",
    "ctai_entity": {
        "ctsynonym_id": "test",
        "content": "test",
        "create_time": "1684670811",
        "update_time": "1684670811 "
    },
    "ctai_synonym_list": [
        {
            "ctsynonym_id": "test",
            "ctai_synonym": {
                "ctsynonym_id": "test",
                "content": "test",
                "create_time": "1684670812",
                "update_time": "1684670812"
            }
        },
        // other synonyms
    ]
}
parameterEnterprise TypeParameter Description
ctsynonym_idstringentity or synonym id
ctai_entityobjectentity word information object
ctai_synonym_listarraysynonym list
contentstringEntity word or synonym content
create_timestringCreation time, integer timestamp, unit is second.
update_timestringModification time, integer timestamp, unit is second.


1. File type document upload interface

request method

  • Request method: POST
  • Request URL: /v1/ctai/ctai_synonym_list
  • Content-Type: application/json

request parameters

{
    "ctsynonym_id": "test",
    "filter_syes_entity_content": "test",
    "filter_syes_synonym_content": "test",
    "filter_syes_keywords": "test",
    "sort_type": "test_id",
    "page" : "1",
    "page_rows": "1"
}
parameterEnterprise TyperequiredParameter Description
ctsynonym_idstringNoEntity word id, multiple separated by English commas
filter_sys_entity_contentstringNoEntity word search keywords, fuzzy matching
filter_sys_synonym_contentstringNoSynonym search keywords, fuzzy matching
filter_sys_keywordsstringNoEntity words or synonyms search keywords, fuzzy matching
sort_typestringNoSorting method, the default is create_time_asc
create_time_asc Sort by creation time from old to new
create_time_desc Sort by creation time from new to old
update_time_asc Sort by modification time from old to new
update_time_desc Sort by modification time from new to old
pagestringNoPaging parameters, the number of pages, starting from 1, the default is 1
page_rowsstringNoPagination parameters, how many items per page, the default is 1

Response business parameters

{
    "total_count": "3",
    "ctai_synonym_entity_list": [
        {
            "ctsynonym_id": "test",
            "ctai_entity": {
                "ctsynonym_id": "test",
                "content": "test" ,
                "create_time": "1684670811",
                "update_time": "1684670811"
            },
            "ctai_synonym_list": [
                {
                    "ctsynonym_id": "test",
                    "ctai_synonym": {
                        "ctsynonym_id": " test",
                        "content": "test",
                        "create_time": "1684670812",
                        "update_time": "1684670812"
                    }
                },
                // other synonyms
            ]
        },
        // other entity words
    ]
}
parameterEnterprise TypeParameter Description
total_countstringThe total number of entity words, used for pagination.
ctai_synonym_entity_listarrayentity word list