مرجع API

API الخاص بـ حل الهوية على الإنترنت

حوّل نطاق شركة إلى هويات عامة يعلن عنها موقعها الإلكتروني صراحةً. استخدم هذا المرجع لاختيار عملية ودمج عقد الاستجابة الموثق.

عرض صفحة المنتج

العمليات

GET /v1/identity-resolution عرض مرجع API

POST /v1/identity-resolution/bulk عرض مرجع API

GET `/v1/identity-resolution`

العملية: resolveInternetIdentity الوحدات والمصادقة: 2 المصادقة مطلوبة

GET /v1/identity-resolution

معاملات الاستعلام

المعامل	النوع	مطلوب
domain	string	مطلوب
skip_cache	string القيم المسموحة `1`	اختياري

حقول الرد

الحقل	النوع
`query`	string
`canonical_domain`	string
`website_url`	string
`fetch_state`	string
`organization`	object
`organization.name`	string \| null
`organization.description`	string \| null
`identities[]`	object[]
`identities[]`	object
`identities[].platform`	string
`identities[].type`	string
`identities[].handle`	string \| null
`identities[].url`	string
`identities[].source`	string
`identities[].confidence`	string
`contacts`	object
`contacts.emails[]`	string[]
`contacts.phones[]`	string[]
`confidence`	number
`evidence`	object
`evidence.declared_identity_count`	integer
`evidence.high_confidence_count`	integer
`evidence.medium_confidence_count`	integer
`evidence.sources[]`	string[]
`meta`	object
`meta.checked_at`	string
`meta.cached`	boolean
`meta.fetch_transport`	string

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/identity-resolution?domain=example.com&skip_cache=example.com"

مثال الرد

{
  "query": "string",
  "canonical_domain": "example.com",
  "website_url": "https://example.com",
  "fetch_state": "ok",
  "organization": {
    "name": "string",
    "description": "198.51.100.10"
  },
  "identities": [
    {
      "platform": "github",
      "type": "social",
      "handle": "example",
      "url": "https://example.com",
      "source": "same_as",
      "confidence": "high"
    }
  ],
  "contacts": {
    "emails": [
      "[email protected]"
    ],
    "phones": [
      "string"
    ]
  },
  "confidence": 1,
  "evidence": {
    "declared_identity_count": 1,
    "high_confidence_count": 1,
    "medium_confidence_count": 1,
    "sources": [
      "string"
    ]
  },
  "meta": {
    "checked_at": "2026-04-15T12:00:00Z",
    "cached": true,
    "fetch_transport": "worker"
  }
}

POST `/v1/identity-resolution/bulk`

العملية: bulkResolveInternetIdentity الوحدات والمصادقة: 2 المصادقة مطلوبة

POST /v1/identity-resolution/bulk

معاملات الجسم

المعامل	النوع	مطلوب
domains	string[]	مطلوب

حقول الرد

الحقل	النوع
`results[]`	object[]
`results[]`	object
`results[].input`	string
`results[].data`	object
`results[].error`	object
`results[].error.error`	object
`results[].error.error.code`	string
`results[].error.error.message`	string
`results[].error.error.suggestion`	string
`results[].error.error.details`	object
`results[].error.error.retry_after`	integer
`results[].error.error.docs_url`	string
`meta`	object
`meta.total`	integer
`meta.succeeded`	integer
`meta.failed`	integer
`meta.max_items`	integer
`meta.credits_per_item`	integer
`meta.duration_ms`	integer

طلب مثال

curl -X POST "https://domscan.net/v1/identity-resolution/bulk" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domains": [
    "stripe.com",
    "github.com"
  ]
}'

مثال الرد

{
  "results": [
    {
      "input": "string",
      "data": {},
      "error": {
        "error": {
          "code": "INVALID_DOMAIN",
          "message": "Invalid domain format",
          "suggestion": "string",
          "details": {},
          "retry_after": 300,
          "docs_url": "/docs#parameters"
        }
      }
    }
  ],
  "meta": {
    "total": 1,
    "succeeded": 1,
    "failed": 1,
    "max_items": 10,
    "credits_per_item": 2,
    "duration_ms": 1
  }
}

موارد المرجع

OpenAPI 3.0 Postman MCP