Profile Status Notification

# Profile Status Notification

# Overview

Notification webhook for profile status changes. This notification is sent to your configured webhook URL when profile status changes occur, allowing you to integrate profile events into your business system.

# API Information

  • Environment: Production
  • Method: POST
  • Endpoint: Your configured webhook URL
  • Content-Type: application/json

# Request

# Request Headers

{
  "Access-Key": "c934e1de7e2153366539c1c03b2bce09",
  "Sign-Method": "SHA256",
  "Timestamp": "1679999518968",
  "Request-ID": "fc61e3ac-cff8-4ca8-8bf6-f7a5f2331b74",
  "Signature": "0bd3d6e33b76840d12584a26018a6e24e32132dd83a17918e994f0f013e6d52a"
}

# Request Parameters

Parameter Type Required Description Validation Rules Example
eid String Yes eUICC Identifier 32 characters 89086030202200000022000014352016
iccid String Yes Integrated Circuit Card Identifier Length: 19-20 characters 89860468152080349618
timestamp String Yes Timestamp 13-digit timestamp 1679999518968
matchingId String Yes Matching ID Non-empty string 794A8542D923A980382AA3862BDB7C3F
configName String Yes Configuration name Non-empty string Test001
type String Yes Notification type Fixed value PROFILE_EVENT_NOTIFICATION
clientIp String Yes Device IP address Valid IP format 192.168.1.100
installedTimes Integer Yes AC download count Positive integer 2
deviceName String No Device name Max length: 64 characters Test001
notificationType String Yes Profile event type See enum values below DOWNLOADED
notificationStatus Object Yes Notification status See object structure below See below

# Notification Types

Value Description
DOWNLOADED Profile downloaded
INSTALLED Profile installed
ENABLE Profile enabled
DISABLE Profile disabled
DELETE Profile deleted

# Notification Status Object

Parameter Type Required Description Example
status String Yes Operation status SUCCESS, FAILED
message String No Error message (null when successful) null

# Example Request

{
  "eid": "89086030202200000022000014352016",
  "iccid": "89860468152080348700",
  "timestamp": "1679999518968",
  "matchingId": "794A8542D923A980382AA3862BDB7C3F",
  "configName": "Test001",
  "type": "PROFILE_EVENT_NOTIFICATION",
  "clientIp": "192.168.1.100",
  "installedTimes": 2,
  "deviceName": "Test001",
  "notificationType": "ENABLE",
  "notificationStatus": {
    "status": "FAILED",
    "message": "Profile has not been released."
  }
}

# Success Example

{
  "eid": "89086030202200000022000014352016",
  "iccid": "89860468152080348700",
  "timestamp": "1679999518968",
  "matchingId": "794A8542D923A980382AA3862BDB7C3F",
  "configName": "Test001",
  "type": "PROFILE_EVENT_NOTIFICATION",
  "clientIp": "192.168.1.100",
  "installedTimes": 1,
  "deviceName": "Test001",
  "notificationType": "DOWNLOADED",
  "notificationStatus": {
    "status": "SUCCESS",
    "message": null
  }
}