برنامه‌نویسان (API)

با API اختصاصی 7one می‌توانید تمام سرویس‌های فعال را از برنامه خود فراخوانی کنید. هزینه هر درخواست از کیف پول کسر می‌شود — دقیقاً مانند استعلام در سایت.

۱. ساخت کلید API

وارد پنل کاربری → برنامه‌نویسان شوید و کلید API بسازید. کلید فقط یک‌بار نمایش داده می‌شود.

۲. احراز هویت

در هدر هر درخواست:

Authorization: Bearer 7one_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

۳. ارسال استعلام

POST https://7one.ir/api/v1/inquiry.php

{
  "service": "shahkar",
  "input": {
    "nationalCode": "0012345678",
    "mobile": "09123456789"
  }
}

۴. پاسخ موفق

{
  "ok": true,
  "message": "موفق",
  "inquiry_id": 42,
  "track_code": "A1B2C3D4E5F6",
  "data": { ... },
  "source": "api"
}

۵. خطاها

• 401 — کلید API نامعتبر
• 402 — موجودی کیف پول کافی نیست
• 404 — سرویس یافت نشد
• 422 — پارامترهای ورودی ناقص یا نامعتبر

۶. فید کاتالوگ محصولات (ترب، BASALAM و ...)

لیست عمومی خدمات با قیمت، تصویر و لینک صفحه سئو برای اتصال به پلتفرم‌های فروش و مقایسه قیمت:

GET https://7one.ir/api/v1/catalog.phpGET https://7one.ir/api/v1/catalog.php?format=torobGET https://7one.ir/api/v1/catalog.php?platform=basalamGET https://7one.ir/api/v1/catalog.php?slug=shahkar

پارامترها: format=json|xml|torob ، platform=basalam ، slug برای یک سرویس. در صورت تنظیم CATALOG_FEED_TOKEN در env، هدر Authorization: Bearer TOKEN الزامی است.

۷. نمونه cURL عمومی

curl -X POST 'https://7one.ir/api/v1/inquiry.php' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"service":"my_ip","input":{}}'

۸. فهرست کامل سرویس‌ها (۴۷ سرویس)

برای هر سرویس، مقدار service را برابر با slug قرار دهید و فیلدهای input را طبق جدول زیر ارسال کنید.

{
    "service": "shahkar",
    "input": {
        "nationalCode": "0012345678",
        "mobile": "09123456789"
    }
}

{
    "service": "shahkar_lite",
    "input": {
        "nationalCode": "0012345678",
        "mobile": "09123456789"
    }
}

{
    "service": "shahkar_pro",
    "input": {
        "nationalCode": "0012345678",
        "mobile": "09123456789"
    }
}

{
    "service": "iban_match",
    "input": {
        "nationalCode": "0012345678",
        "birthDate": "1370\/01\/01",
        "iban": "IR120170000000123456789012"
    }
}

{
    "service": "card_match",
    "input": {
        "nationalCode": "0012345678",
        "birthDate": "1370\/01\/01",
        "cardNumber": "6037991234567890"
    }
}

{
    "service": "card_mobile_match",
    "input": {
        "mobile": "09123456789",
        "cardNumber": "6037991234567890"
    }
}

{
    "service": "bank_account_info",
    "input": {
        "accountNumber": "1234567890",
        "bankCode": "017"
    }
}

{
    "service": "iban_info",
    "input": {
        "iban": "IR120170000000123456789012"
    }
}

{
    "service": "bank_card_info",
    "input": {
        "cardNumber": "6037991234567890"
    }
}

{
    "service": "card_info",
    "input": {
        "cardNumber": "6037991234567890"
    }
}

{
    "service": "card_to_iban",
    "input": {
        "cardNumber": "6037991234567890"
    }
}

{
    "service": "cheque_color",
    "input": {
        "nationalCode": "0012345678"
    }
}

{
    "service": "cheque_info",
    "input": {
        "chequeID": "1234567890123456"
    }
}

{
    "service": "unpaid_cheque_lite",
    "input": {
        "nationalCode": "0012345678"
    }
}

{
    "service": "company_info",
    "input": {
        "nationalID": "10101234567"
    }
}

{
    "service": "company_members",
    "input": {
        "nationalID": "10101234567"
    }
}

{
    "service": "company_newspapers",
    "input": {
        "nationalID": "10101234567"
    }
}

{
    "service": "sana",
    "input": {
        "nationalCode": "0012345678"
    }
}

{
    "service": "enamad",
    "input": {
        "domain": "example.com"
    }
}

{
    "service": "water_bill",
    "input": {
        "billID": "1234567890123"
    }
}

{
    "service": "power_bill",
    "input": {
        "billID": "1234567890123"
    }
}

{
    "service": "gas_bill",
    "input": {
        "billID": "1234567890123"
    }
}

{
    "service": "is_holiday",
    "input": []
}

{
    "service": "check_email",
    "input": {
        "email": "user@example.com"
    }
}

{
    "service": "my_ip",
    "input": []
}

{
    "service": "ip_is_iran",
    "input": {
        "ip": "1.2.3.4"
    }
}

{
    "service": "ip_location",
    "input": {
        "ip": "1.2.3.4"
    }
}

{
    "service": "geo_to_address",
    "input": {
        "latitude": "35.6892",
        "longitude": "51.3890"
    }
}

{
    "service": "wallpaper",
    "input": []
}

{
    "service": "text_to_speech",
    "input": {
        "text": "سلام 7one",
        "male": "مقدار نمونه",
        "ttsEngine": "مقدار نمونه"
    }
}

{
    "service": "postal_tracking",
    "input": {
        "trackingCode": "12345678901234567890"
    }
}

{
    "service": "call_otp",
    "input": {
        "code": "1234",
        "number": "09123456789"
    }
}

{
    "service": "call_otp_alt",
    "input": {
        "code": "1234",
        "number": "09123456789"
    }
}

{
    "service": "sms_otp",
    "input": {
        "code": "1234",
        "mobile": "09123456789"
    }
}

{
    "service": "postal_code_info",
    "input": {
        "postalCode": "مقدار نمونه"
    }
}

{
    "service": "unpaid_cheque",
    "input": {
        "nationalCode": "0012345678"
    }
}

{
    "service": "company_signatories",
    "input": {
        "nationalID": "10101234567"
    }
}

{
    "service": "tax_records",
    "input": {
        "inquiryCode": "مقدار نمونه"
    }
}

{
    "service": "gas_bill_info",
    "input": {
        "billID": "1234567890123"
    }
}

{
    "service": "nationality_status",
    "input": {
        "code": "1234",
        "codeType": "مقدار نمونه"
    }
}

{
    "service": "business_license",
    "input": {
        "trackingCode": "12345678901234567890"
    }
}

{
    "service": "person_info",
    "input": {
        "nationalCode": "0012345678",
        "birthDate": "1370\/01\/01"
    }
}

{
    "service": "iban_match_pro",
    "input": {
        "nationalCode": "0012345678",
        "iban": "IR120170000000123456789012"
    }
}

{
    "service": "water_bill_info",
    "input": {
        "billID": "1234567890123"
    }
}

{
    "service": "military_status",
    "input": {
        "nationalCode": "0012345678",
        "birthDate": "1370\/01\/01"
    }
}

{
    "service": "video_verify",
    "input": {
        "nationalCode": "0012345678",
        "birthDate": "1370\/01\/01",
        "serialNumber": "مقدار نمونه",
        "speechText": "مقدار نمونه",
        "videoBase64": "مقدار نمونه"
    }
}

{
    "service": "power_bill_info",
    "input": {
        "billID": "1234567890123"
    }
}