Installation

Identity of the token's install and store

Needs no scope. Returns the platform-issued ids an app must key its storage on (install.id, store.id), the effective scope set every request is checked against, the store's currency exponent, locale and timezone, and the current webhook subscription without its secret. store.slug is display-only and can change.

المعاملات

لا معاملات.

الاستجابات

200

The install and its store

الاسم	النوع	الوصف
`data`مطلوب	Installation	The install and the store it is bound to, as the platform sees them.

401
Missing, invalid, expired, or revoked token
429
Token budget exhausted (180 requests/minute, 60 writes/minute per install)

الطلب

curl -X GET "https://dukkan.one/platform-api/v1/installation" \
  -H "Authorization: Bearer $DUKKAN_ACCESS_TOKEN"

الاستجابة

{
  "data": {
    "install": {
      "id": "6f1d2c3b-4a59-4e8f-9b70-2d1c3e4f5a6b",
      "app_id": "6f1d2c3b-4a59-4e8f-9b70-2d1c3e4f5a6b",
      "status": "active",
      "granted_scopes": [
        "string"
      ],
      "effective_scopes": [
        "string"
      ],
      "distribution_channel": "development",
      "installed_at": "2026-08-18T16:00:00Z",
      "api_version": "string",
      "webhook": {
        "id": "6f1d2c3b-4a59-4e8f-9b70-2d1c3e4f5a6b",
        "endpoint_url": "string",
        "topics": [
          "order.created"
        ],
        "status": "active",
        "consecutive_failures": 1,
        "activated_at": "2026-08-18T16:00:00Z",
        "disabled_at": "2026-08-18T16:00:00Z"
      }
    },
    "store": {
      "id": "6f1d2c3b-4a59-4e8f-9b70-2d1c3e4f5a6b",
      "slug": "string",
      "name": "Olive oil 1 L",
      "currency": "SYP",
      "decimals": 0,
      "locale": "string",
      "timezone": "string",
      "country": "string",
      "is_development": true
    }
  }
}