메인 콘텐츠로 건너뛰기
POST
curl
이 자격 증명은 SDK 이벤트 제출에서 설명하는 기기 경로에서 사용됩니다. 해당 페이지에서는 모든 기기 요청에 대해 서버가 적용하는 조건과, 백프레셔 상황에서 손실되어도 안전한 이벤트도 확인할 수 있습니다.

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json

camelCase 별칭이 허용됩니다: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
필수

이 자격 증명으로 제출된 모든 이벤트가 속한 대상에 대한 귀하의 id입니다.

Required string length: 1 - 255
entity_type
string
기본값:individual

company는 기업 대상을 바인딩합니다. 다른 값(기본값 individual)은 개인을 바인딩합니다.

Maximum string length: 32
allowed_event_categories
enum<string>[]

자격 증명이 제출할 수 있는 카테고리. 생략하거나 []를 전송하면 모든 카테고리를 허용합니다.

사용 가능한 옵션:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
기본값:900

자격 증명의 유효 기간(초 단위)입니다.

필수 범위: 60 <= x <= 86400
max_uses
integer | null
기본값:1000

자격 증명이 제출할 수 있는 이벤트 수입니다(배치는 이벤트당 1회 사용량을 차감합니다). 유효 기간 내에 제한을 두지 않으려면 null을 전송하십시오.

필수 범위: x >= 1
bind_to_origin
string | null

설정된 경우 모든 디바이스 요청의 브라우저 Origin 헤더가 이 값과 정확히 일치해야 합니다. Origin이 없는 요청은 거부됩니다.

Maximum string length: 255

응답

자격 증명이 발급되었습니다. 앱에 monitoring_token을 전달하고 expires_at까지 비밀로 취급하세요.

monitoring_token
string
필수

기기 자격 증명(43자의 URL-safe token)입니다. X-Monitoring-Token 헤더에 담아 전송하세요.

expires_at
string<date-time>
필수

자격 증명이 더 이상 허용되지 않는 시점입니다.

allowed_event_categories
enum<string>[]
필수

자격 증명이 제출할 수 있는 카테고리. []는 모든 카테고리를 의미합니다.

사용 가능한 옵션:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
필수

자격 증명의 이벤트 예산입니다. null은 한도가 없음을 의미합니다.

bind_to_origin
string | null
필수

자격 증명이 바인딩된 오리진(Origin) 또는 null입니다.

마지막 수정일 2026년 11월 7일