1. 홈
  2. 사용 설명서
  3. RESTful API 문서
  4. 카운팅 데이터 API [베타]
수색...

카운팅 데이터 API [베타]

상품 설명 JSON 형식의 카운팅 데이터를 가져오기 위해 JSON 문자열에서 카운팅 데이터 유형 및 쿼리 페이로드 개체를 제공하여 이 끝점을 호출합니다.
종점

{CubeHostAddress}/API/v1/로드

{CubeHostAddress}: https://cube.footfallcam.com(온프레미스 솔루션을 사용하는 경우 호스트 주소에서 FootfallCam 지원팀에 문의하세요)
방법 POST
헤더
  1. 권한 부여 : 토큰 값 반환 API '액세스 토큰 생성' 사용자 이름 및 암호를 제공하여
본문 - JSON 예 {
    "쿼리": {
        "측정": [
            "ThisCubeName.FC01_SUM",
            "ThisCubeName.FC01_AVG",
            "ThisCubeName.FC02_SUM",
            "ThisCubeName.FC02_AVG"
        ],
        "timeDimensions": [
            {
                "차원": "ThisCubeName.Time",
                "날짜 범위": [
                    "2021-10-01T10:00:00.000",
                    "2021년 10월 31일"
                ],
                "세분성": "시간"
            }
        ],
        "주문하다": [
            [
                "ThisCubeName.FC01_SUM",
                "설명"
            ]
        ],
        "필터": [
            {
                "구성원": "ThisCubeName.CompanyId",
                "연산자": "같음",
                "값": [
                    "1001"
                ]
            },
            {
                "구성원": "ThisCubeName.BranchId",
                "연산자": "같음",
                "값": [
                    "2001",
                    "2001"
                ]
            },
            {
                "구성원": "ThisCubeName.BranchName",
                "연산자": "같음",
                "값": [
                    "지점이름1",
                    "지점명2"
                ]
            },
            {
                "구성원": "ThisCubeName.AreaId",
                "연산자": "같음",
                "값": [
                    "3001",
                    "3002",
                    "3003"
                ]
            }
        ],
        "차원": [
            "ThisCubeName.CompanyId",
            "ThisCubeName.CompanyName",
            "ThisCubeName.BranchId",
            "ThisCubeName.BranchName",
            "ThisCubeName.AreaId",
            "ThisCubeName.AreaName"
        ],
        "제한": 50000
    }
}
본체 설명

큐브 이름은 페이로드에 언급되어야 하며 사용 가능한 필드는 선택한 큐브에 따라 다릅니다. 참조하시기 바랍니다 큐브 목록 큐브 세부 정보

  1. 쿼리(객체) : 쿼리 데이터에 대한 페이로드 정의
  2. 측정값(문자열 목록) : 메트릭 코드 목록 및 집계 유형을 정의합니다.
  3. timeDimensions(객체 목록) : 시간 관련 매개변수를 정의하는 객체를 포함합니다.
    1. 차원(문자열) : 시간 관련 매개변수를 적용하기 위한 차원을 지정합니다.
    2. dateRange(문자열 목록) : 데이터 쿼리의 시작 및 종료 날짜 시간을 지정합니다. 예: "2021-10-01T10:00:00.000", "2021-10-31"
    3. granularity (string) : 데이터의 시간 단위를 정의합니다. 예: 분, 시, 일, 주, 월, 년
  4. order (문자열 목록 목록) : 데이터의 순서를 지정합니다. 각 부 목록에는 순서를 적용할 필드 이름과 해당 순서 유형이 포함됩니다. 예 : ["ThisCubeName.FC01_SUM", "desc"]
  5. 필터(객체 목록) : 쿼리 데이터의 필터링을 정의합니다.
    1. 멤버(문자열) : 필터를 적용할 차원을 지정합니다.
    2. operator(string) : 필터의 유형을 정의합니다. 예: 같음, notEquals, 포함, notContains
    3. values(list of string) : 데이터 필터링을 위한 값을 지정합니다.
  6. 차원(문자열 목록) : SQL 쿼리의 'Select' 문과 유사하게 결과 데이터에 표시할 차원을 지정합니다.
  7. limit (int, optional) : 반환되는 데이터의 최대 레코드 수를 지정합니다. 기본값은 10000(페이로드에 지정되지 않은 경우)이고 최대값은 50000입니다.
응답 1 - JSON 예 {
    "오류": "계속 기다리십시오",
    "무대": {
        "stage": "쿼리 실행 중",
        "시간 경과": 5003
    }
}
응답 1 설명 '계속 대기' 응답은 단순히 백엔드가 쿼리를 실행하고 결과를 반환하는 데 시간이 걸릴 수 있음을 나타냅니다. API 호출 실패로 인한 것이 아니라 쿼리가 백엔드에서 실행 중입니다. 나중에 다시 시도하면 백엔드가 쿼리를 실행하면 API가 결과를 반환합니다.
응답 2 - JSON 예 {
    "쿼리": {},
    "데이터": [
{
            "cube3.CompanyId": "18330",
            "cube3.CompanyName": "데모회사",
            "cube3.BranchId": "23097",
            "cube3.BranchName": "UKSite01",
            "cube3.AreaId": "-1",
            "cube3.AreaName": null로,
            "cube3.Time.hour": "2022-01-15T11:00:00.000",
            "cube3.Time": "2022-01-15T11:00:00.000",
            "cube3.FC01_SUM": 200,
            "cube3.FC01_MAX": 180,
            "cube3.FC01_AVG": 100,
            "cube3.FC01_MIN": 20,
            "cube3.FC02_SUM": 188,
            "cube3.FC02_MAX": 171,
            "cube3.FC02_AVG": 94,
            "cube3.FC02_MIN": 17
        },
        {
            "cube3.CompanyId": "18330",
            "cube3.CompanyName": "데모회사",
            "cube3.BranchId": "23097",
            "cube3.BranchName": "UKSite01",
            "cube3.AreaId": "-1",
            "cube3.AreaName": null로,
            "cube3.Time.hour": "2022-01-07T15:00:00.000",
            "cube3.Time": "2022-01-07T15:00:00.000",
            "cube3.FC01_SUM": 175,
            "cube3.FC01_MAX": 100,
            "cube3.FC01_AVG": 87.5,
            "cube3.FC01_MIN": 75,
            "cube3.FC02_SUM": 174,
            "cube3.FC02_MAX": 95,
            "cube3.FC02_AVG": 87,
            "cube3.FC02_MIN": 79
        },
        {
            "cube3.CompanyId": "18330",
            "cube3.CompanyName": "데모회사",
            "cube3.BranchId": "23097",
            "cube3.BranchName": "UKSite01",
            "cube3.AreaId": "-1",
            "cube3.AreaName": null로,
            "cube3.Time.hour": "2022-01-15T13:00:00.000",
            "cube3.Time": "2022-01-15T13:00:00.000",
            "cube3.FC01_SUM": 171,
            "cube3.FC01_MAX": 151,
            "cube3.FC01_AVG": 85.5,
            "cube3.FC01_MIN": 20,
            "cube3.FC02_SUM": 166,
            "cube3.FC02_MAX": 146,
            "cube3.FC02_AVG": 83,
            "cube3.FC02_MIN": 20
        }
],
    "lastRefreshTime": "2022-01-19T07:35:41.259Z",
    "새로 고침 키 값": [
        [
            {
                "새로고침_키": "13688147"
            }
        ]
    ],
    "usedPreAggregations": {},
    "변환된 쿼리": {},
    "requestId": "dda53bef-4d52-4377-aee8-74d2976cafc6-span-1",
    "주석": {},
    "데이터 소스": "기본값",
    "dbType": "prestodb",
    "extDbType": "큐브스토어",
    "외부": 거짓,
    "slowQuery": 거짓
}
응답 2 설명 카운팅 데이터 결과는 '데이터' 섹션에 개체 목록으로 표시되며, 다른 추가 정보는 향후 제거될 수 있습니다.
2 월 22, 2023에 업데이트 됨