SAAS saas_plat openapi customer_fields - nxtele/nxcloud-doc-en GitHub Wiki

Query Customer Fields API

Query Customer Fields API

  • URL: https://api.nxcloud.com/saas/cdp/openapi/customers/fields
  • Method: GET
  • Content-Type: application/json
  • Requires authentication: Yes

Request Parameters

Header Parameters:

Parameter Name Type Required Example Value Description
accessKey String Yes fme2na3kdi3ki User identity identifier
ts String Yes 1655710885431 Current request timestamp (in milliseconds). The maximum allowed time difference is 60 seconds
bizType String Yes 2 WhatsApp business type, fixed value "2"
action String Yes mt WhatsApp business operation, fixed value "mt"
sign String Yes 6e9506557d1f289501d333ee2c365826 API input parameter signature, common convention

Params Parameters:

Parameter Name Type Required Example Value Description
tenant_id integer Yes 123 Tenant ID
app_key string Yes Lfap8mE App key
is_preset boolean No - Optional. true: system preset, false: non-system preset. Display all if not provided

Response Parameters

Parameter Name Type Description
code Integer Result code
data array Request result
message String Request message
traceId String Trace ID
  • data array parameters:
Parameter Name Type Description
id Integer ID
tenantId Integer Tenant ID
name String Field name
display_name String Display name
display_en_name String Display name (English)
is_display Boolean Whether to display
field_type Integer Field type
required Boolean Whether required
sequence String Field sequence
remark String Remark
field_type_info String Field type definition information
is_preset Boolean Whether system preset

Response Example

Successful Example

{
    "code": 0,
    "message": "",
    "data": [
        {
            "id": 4071,
            "tenantId": 144,
            "name": "first_name",
            "required": false,
            "sequence": 1,
            "remark": null,
            "display_name": "First Name",
            "display_en_name": "First Name",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4072,
            "tenantId": 144,
            "name": "last_name",
            "required": false,
            "sequence": 2,
            "remark": null,
            "display_name": "Last Name",
            "display_en_name": "Last Name",
            "is_display": false,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4073,
            "tenantId": 144,
            "name": "sms_phone",
            "required": false,
            "sequence": 3,
            "remark": null,
            "display_name": "Phone",
            "display_en_name": "Phone Number",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4074,
            "tenantId": 144,
            "name": "whats_app_phone",
            "required": false,
            "sequence": 4,
            "remark": null,
            "display_name": "WhatsApp",
            "display_en_name": "WhatsApp",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4075,
            "tenantId": 144,
            "name": "email",
            "required": false,
            "sequence": 5,
            "remark": null,
            "display_name": "Email",
            "display_en_name": "Email",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4076,
            "tenantId": 144,
            "name": "tags",
            "required": false,
            "sequence": 6,
            "remark": null,
            "display_name": "Tag",
            "display_en_name": "Tag",
            "is_display": true,
            "field_type": 7,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4077,
            "tenantId": 144,
            "name": "created_at",
            "required": false,
            "sequence": 7,
            "remark": null,
            "display_name": "Create time",
            "display_en_name": "Updated at",
            "is_display": true,
            "field_type": 6,
            "field_type_info": "{\"formatter\": \"yyyy-MM-dd HH:mm:ss\"}",
            "is_preset": true
        },
        {
            "id": 4078,
            "tenantId": 144,
            "name": "updated_at",
            "required": false,
            "sequence": 8,
            "remark": null,
            "display_name": "Update time",
            "display_en_name": "Created at",
            "is_display": true,
            "field_type": 6,
            "field_type_info": "{\"formatter\": \"yyyy-MM-dd HH:mm:ss\"}",
            "is_preset": true
        },
        {
            "id": 4079,
            "tenantId": 144,
            "name": "country",
            "required": false,
            "sequence": 9,
            "remark": null,
            "display_name": "Country",
            "display_en_name": "Country",
            "is_display": false,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4080,
            "tenantId": 144,
            "name": "time_zone",
            "required": false,
            "sequence": 10,
            "remark": null,
            "display_name": "Time Zone",
            "display_en_name": "Time Zone",
            "is_display": false,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4081,
            "tenantId": 144,
            "name": "age",
            "required": false,
            "sequence": 11,
            "remark": null,
            "display_name": "Age",
            "display_en_name": "Age",
            "is_display": false,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": true
        },
        {
            "id": 4082,
            "tenantId": 144,
            "name": "birthday",
            "required": false,
            "sequence": 12,
            "remark": null,
            "display_name": "Birth",
            "display_en_name": "The date of birth",
            "is_display": false,
            "field_type": 5,
            "field_type_info": "{\"formatter\": \"yyyy-MM-dd\"}",
            "is_preset": true
        },
        {
            "id": 4083,
            "tenantId": 144,
            "name": "gender",
            "required": false,
            "sequence": 13,
            "remark": null,
            "display_name": "Gender",
            "display_en_name": "Gender",
            "is_display": false,
            "field_type": 3,
            "field_type_info": "[{\"id\": \"1\", \"name\": \"男\", \"i18nCode\": \"saas.plat.api.11156\"}, {\"id\": \"0\", \"name\": \"女\", \"i18nCode\": \"saas.plat.api.11188\"}]",
            "is_preset": true
        },
        {
            "id": 4136,
            "tenantId": 144,
            "name": "customize_1_13",
            "required": false,
            "sequence": 14,
            "remark": null,
            "display_name": "text",
            "display_en_name": "text",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": false
        },
        {
            "id": 4137,
            "tenantId": 144,
            "name": "customize_1_14",
            "required": false,
            "sequence": 15,
            "remark": null,
            "display_name": "Custom field 2",
            "display_en_name": "Custom field 2",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": false
        },
        {
            "id": 4138,
            "tenantId": 144,
            "name": "customize_1_15",
            "required": false,
            "sequence": 16,
            "remark": null,
            "display_name": "Custom field 3",
            "display_en_name": "Custom field 3",
            "is_display": true,
            "field_type": 1,
            "field_type_info": null,
            "is_preset": false
        },
        {
            "id": 4139,
            "tenantId": 144,
            "name": "customize_2_16",
            "required": false,
            "sequence": 17,
            "remark": null,
            "display_name": "number",
            "display_en_name": "number",
            "is_display": true,
            "field_type": 2,
            "field_type_info": null,
            "is_preset": false
        },
        {
            "id": 4140,
            "tenantId": 144,
            "name": "customize_3_17",
            "required": false,
            "sequence": 18,
            "remark": null,
            "display_name": "Single choice",
            "display_en_name": "Single choice",
            "is_display": true,
            "field_type": 3,
            "field_type_info": "[{\"id\": \"1\", \"name\": \"A\"}, {\"id\": \"2\", \"name\": \"B\"}, {\"id\": \"1682407283267\", \"name\": \"C\"}]",
            "is_preset": false
        },
        {
            "id": 4141,
            "tenantId": 144,
            "name": "customize_4_18",
            "required": false,
            "sequence": 19,
            "remark": null,
            "display_name": "Multiple choice",
            "display_en_name": "Multiple choice",
            "is_display": true,
            "field_type": 4,
            "field_type_info": "[{\"id\": \"1\", \"name\": \"A\"}, {\"id\": \"2\", \"name\": \"B\"}, {\"id\": \"1682407301578\", \"name\": \"C\"}]",
            "is_preset": false
        },
        {
            "id": 4142,
            "tenantId": 144,
            "name": "customize_5_19",
            "required": false,
            "sequence": 20,
            "remark": null,
            "display_name": "date",
            "display_en_name": "date",
            "is_display": true,
            "field_type": 5,
            "field_type_info": "{\"formatter\": \"yyyy-MM-dd\"}",
            "is_preset": false
        },
        {
            "id": 4143,
            "tenantId": 144,
            "name": "customize_6_20",
            "required": false,
            "sequence": 21,
            "remark": null,
            "display_name": "date time",
            "display_en_name": "date time",
            "is_display": true,
            "field_type": 6,
            "field_type_info": "{\"formatter\": \"yyyy-MM-dd HH:mm:ss\"}",
            "is_preset": false
        }
    ],
    "traceId": "148b351a19514993951c549dc7ddd077"
}