اپنے پیغامات کے پیچھے کاروبار رجسٹر کریں
پیغام رسانی برانڈ امریکی 10DLC پیغامات بھیجنے والے کاروبار کی شناخت کرتا ہے. مہم کے استعمال کا معاملہ منتخب کرنے سے پہلے برانڈ رجسٹر کریں. کاروبار کی قانونی تفصیلات اور ایسا رابطہ استعمال کریں جو مطلوبہ توثیق مکمل کر سکے. واپس کیا گیا برانڈ شناخت کنندہ خود بخود پیغامات بھیجنے کی منظوری نہیں ہے.
اس موجودہ اکاؤنٹ ملکیتی روٹ کو HTTPS پر فعال API اکاؤنٹ اور اس کے اجازت یافتہ سورس IP پتے کے ساتھ استعمال کریں. user_id, username یا کسی دوسرے گاہک کا مالک شناخت کنندہ جمع نہ کریں. MultiTEL تصدیق شدہ اکاؤنٹ سے ملکیت درج کرتا ہے.
واضح سینڈ باکس درخواست سے شروع کریں
پورٹل اپنا فارم سینڈ باکس mode پر پہلے سے طے کرتا ہے; براہ راست API درخواست میں JSON بولین mock: true واضح طور پر شامل کرنا ضروری ہے جب آپ فرضی برانڈ چاہتے ہیں. اس فلیگ کو چھوڑنا سینڈ باکس کی ضمانت نہیں ہے اور قابل وصول پروڈکشن رجسٹریشن بنا سکتا ہے. پورٹل کا mode فیلڈ API کے mock فیلڈ کا متبادل نہیں ہے.
نیچے دیے گئے فیلڈز استعمال کر کے مقامی brand.json فائل تیار کریں. پلیس ہولڈرز کو مناسب ٹیسٹ تفصیلات اور موجودہ کیٹلاگ کوڈز سے بدل دیں. یہ مثال نجی منافع بخش کاروبار ہے; دیگر اینٹیٹی اقسام کی ضروریات مختلف ہیں.
{
"entityType": "PRIVATE_PROFIT",
"displayName": "Example business",
"companyName": "Example legal business name",
"ein": "YOUR_TAX_ID",
"einIssuingCountry": "US",
"phone": "+12025550123",
"street": "123 Example Street",
"city": "Example City",
"state": "NY",
"postalCode": "10001",
"country": "US",
"email": "contact@example.invalid",
"brandRelationship": "BASIC_ACCOUNT",
"vertical": "CURRENT_VERTICAL_CODE",
"referenceId": "your-business-reference",
"mock": true
}اوپر دیا گیا کاروبار, پتہ, فون اور شناخت کنندہ پلیس ہولڈر ہیں, رجسٹریشن کے لیے تیار کاروباری شناخت نہیں. entityType, vertical, country, state, brandRelationship اور دیگر شمار کردہ اقدار کے لیے موجودہ قدریں پیغام رسانی کیٹلاگ سے حاصل کریں.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $IDEMPOTENCY_KEY" \
--data-binary @brand.json \
'https://api.multitel.net/tcr/v2/brand/nonBlocking'کاروباری اور رابطہ فیلڈز
| فیلڈز | کیا فراہم کریں |
|---|---|
| entityType, displayName | موجودہ اینٹیٹی قسم کا کوڈ اور پہچانے جانے والا برانڈ نام. زیادہ سے زیادہ لمبائی بالترتیب 20 اور 255 حروف ہے. |
| country, street, city, state, postalCode | کاروبار کا اصل پتہ. دو حرفی ملکی کوڈ اور قابل اطلاق ہونے پر موجودہ امریکی state کوڈ استعمال کریں. حدود: street 255, city 100, state 20 اور postalCode 10 حروف. |
| email, phone | کام کرنے والا رابطہ ای میل, 100 حروف تک, اور بین الاقوامی + ملکی کوڈ فارمیٹ میں فون نمبر, 20 حروف تک. رجسٹریشن میں کاروباری تفصیلات مستقل رکھیں. |
| companyName, ein, einIssuingCountry | تنظیموں کے لیے, قانونی کمپنی کا نام اور کاروباری ٹیکس شناخت کنندہ فراہم کریں. شناخت کنندہ کا اجراء کرنے والا ملک الگ دو حرفی فیلڈ ہے. حدود: companyName 255 اور ein 21 حروف. واحد مالک تنظیم کی ٹیکس شناخت کے بجائے ذاتی نام کے فیلڈز استعمال کرتا ہے. |
| brandRelationship, vertical | کاروبار سے تعلق اور اس کی صنعت, موجودہ کیٹلاگ کوڈز استعمال کرتے ہوئے. تنظیموں کے لیے یہ ضروری ہیں; واحد مالک کے اصول مختلف ہیں. API کوڈز کے لیے ترجمہ شدہ ڈسپلے لیبل متبادل نہ کریں. |
| firstName, lastName, mobilePhone | واحد مالک کے لیے ضروری. نام کے فیلڈز ہر ایک 100 حروف تک کی اجازت دیتے ہیں. مطلوبہ OTP توثیق کے لیے اہل موبائل نمبر بین الاقوامی فارمیٹ میں فراہم کریں. |
| stockSymbol, stockExchange, website, businessContactEmail | عوامی کمپنی کو اضافی توثیقی عمل کے لیے اسٹاک علامت/ایکسچینج, website اور اہل کاروباری رابطہ ای میل بھی درکار ہے. حدود: stockSymbol 10, website 255 اور businessContactEmail 255 حروف. |
| altBusinessIdType, altBusinessId | اختیاری متبادل کاروباری شناخت کنندہ. اس کی قسم اور قدر ایک ساتھ فراہم کریں. موجودہ قسم کیٹلاگ استعمال کریں; قدر 50 حروف تک کی اجازت دیتی ہے. |
| referenceId | آپ کا کاروباری حوالہ, 50 حروف تک. موجودہ اینٹیٹی مخصوص ضروریات کے تحت واحد مالک رجسٹریشن کے لیے اسے شامل کریں. یہ کاروباری میٹا ڈیٹا ہے, درخواست کی آئیڈمپوٹینسی کلید نہیں. |
| website, ipAddress, tag | اضافی ویب سائٹ, اصل IP میٹا ڈیٹا اور ٹیگ اقدار جب قابل اطلاق ہوں. یہ اکاؤنٹ ملکیت قائم نہیں کرتے یا شناختی جانچوں کا متبادل نہیں ہیں. |
| mock | JSON بولین. مطلوبہ فرضی ورک فلو کے لیے صرف true استعمال کریں; واضح طور پر جائزہ شدہ پروڈکشن رجسٹریشن کے لیے false استعمال کریں. JSON بولین کے متبادل کے طور پر سٹرنگ "false" نہ بھیجیں. |
واحد مالکان امریکی یا کینیڈین رجسٹریشنوں کے لیے معاون ہیں اور مہم کی اہلیت سے پہلے OTP تصدیق درکار ہے. عوامی کمپنیوں کو کاروباری رابطہ توثیقی مرحلہ درکار ہو سکتا ہے. GOVERNMENT امریکہ میں مقیم سرکاری اداروں کے لیے ہے; دیگر تنظیموں کے لیے درست اینٹیٹی زمرہ کی تصدیق کریں. اینٹیٹی مخصوص ضروریات اور واپس کی گئی توثیقی غلطیوں دونوں پر عمل کریں.
مستحکم آئیڈمپوٹینسی کلید رکھیں
اس مطلوبہ رجسٹریشن کے لیے ایک Idempotency-Key بنائیں. اس میں بغیر خالی جگہوں کے 1–128 قابل طباعت ASCII حروف ہونے چاہئیں. اسی کلید کو صرف اسی HTTP طریقہ, پاتھ, کوئری سٹرنگ اور عین درخواست باڈی بائٹس کے ساتھ دوبارہ استعمال کریں. JSON کو دوبارہ فارمیٹ کرنا, اس کا مطلب بدلے بغیر بھی, درخواست کے فنگر پرنٹ کو بدل دیتا ہے.
مکمل کلید والی درخواست دوسری رجسٹریشن جمع کرائے بغیر اپنا محفوظ جواب دوبارہ چلا سکتی ہے. زیر عمل نقل HTTP 409 واپس کرتی ہے اور Retry-After شامل کر سکتی ہے. اسی کلید کے ساتھ بدلی ہوئی درخواست متصادم ہوتی ہے. صرف اس لیے نئی کلید نہ بنائیں کہ درخواست کا وقت ختم ہوا یا غلطی واپس آئی: کاروبار پہلے ہی رجسٹر ہو چکا ہو سکتا ہے.
اس درخواست کو حل کرتے ہوئے brand.json کو بغیر تبدیلی رکھیں. کیش شدہ 500 یا 502 رجسٹریشن دوبارہ آزمانے کے بجائے اصل غلطی دوبارہ چلا سکتا ہے. واپس کیے گئے brandId, requestId اور ارتباط ہیڈرز کو محفوظ رکھیں; مختلف درخواست شروع کرنے سے پہلے موجودہ برانڈ کا ملان کریں.
برانڈ اور اس کی حالت پڑھیں
یہ API HTTP اسٹیٹس کوڈز اور براہ راست JSON باڈی استعمال کرتا ہے, v3 status/response لفافے کے بجائے. کامیاب رجسٹریشن brandId سمیت برانڈ آبجیکٹ واپس کرتی ہے. اس شناخت کنندہ کو محفوظ کریں اور واپس کی گئی توثیق یا شناختی حالت کا معائنہ کریں. اضافی فیلڈز اینٹیٹی اور رجسٹریشن حالت پر منحصر ہیں.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/tcr/v2/brand/$BRAND_ID"صرف اپنے اکاؤنٹ کا برانڈ پڑھیں. 404 کا مطلب ہو سکتا ہے کہ برانڈ اس اکاؤنٹ کے لیے دستیاب نہیں ہے. مطلوبہ توثیق مکمل کریں, پھر برانڈ اہلیت کی مدد سے اس کے دستیاب مہم استعمال کے معاملات تلاش کریں. فرضی وسائل کو پروڈکشن بھیجنے کے لیے اہل نہیں سمجھا جا سکتا.
پروڈکشن فیسیں
| رجسٹریشن | فیس |
|---|---|
| معیاری تنظیم | $5.00 |
| واحد مالک | $4.45 |
| فرضی برانڈ | فرضی ورک فلو میں کوئی برانڈ رجسٹریشن ڈیبٹ نہیں |
یہ خوردہ رقمیں 24 اکتوبر 2026 کو موجودہ پورٹل ترتیب کے مقابل جانچی گئیں. پروڈکشن رجسٹریشن سے پہلے پورٹل میں موجودہ فیس کی تصدیق کریں. مہم چارجز, اضافی جانچ اور پیغام رسانی استعمال الگ ہیں. پروڈکشن رجسٹریشن جمع کرانے سے پہلے خریداری اجازت اور دستیاب فنڈنگ جانچتی ہے; رجسٹری میں برانڈ کا کامیاب اندراج اور مقامی بلنگ الگ عملی مراحل ہیں, اس لیے وسائل کی شناخت محفوظ رکھیں اور غلطی یا بلنگ مسئلہ ہونے پر لین دین کا ملان کریں.
فرضی برانڈ کو پروڈکشن میں بدلنا الگ سے تصدیق شدہ ورک فلو ہے اور نئی پروڈکشن شناخت اور چارج بنا سکتا ہے. یہ نہ سمجھیں کہ بعد کی درخواست پر mock کو false میں ترمیم کرنا موجودہ برانڈ کو بدل دیتا ہے.
برانڈ کو نقل بنائے بغیر غلطیوں سے نمٹیں
| HTTP نتیجہ | کیا جانچیں |
|---|---|
| 400 | فیلڈ غلطیاں پڑھیں. رجسٹری توثیقی غلطیاں code/description آبجیکٹس کی صف ہو سکتی ہیں. مقامی آئیڈمپوٹینسی کلید توثیق بھی 400 واپس کر سکتی ہے. |
| 401, 403 یا 404 | API اسناد, API اکاؤنٹ کا اجازت یافتہ سورس IP, گاہک اجازتیں اور ملکیت جانچیں. رجسٹری جواب اپنی اجازت کی غلطی بھی لا سکتا ہے. |
| 402 | فنڈنگ اور خریداری اجازت کا جائزہ لیں. غیر فنڈ شدہ پروڈکشن درخواست کو سینڈ باکس ٹیسٹ نہ سمجھیں. |
| 409 | زیر عمل درخواست کا انتظار کرتے ہوئے وہی کلید اور بغیر تبدیلی درخواست رکھیں. بدلی ہوئی باڈی/کلید تصادم یا ناقابل بحالی پیشگی جواب کو پہلے ملان درکار ہے. |
| 429 یا محدود کنندہ دستیاب نہ ہونے کا جواب | موجود ہونے پر Retry-After کا احترام کریں. حد ختم ہونے کے بعد وہی مطلوبہ درخواست اور کلید دوبارہ آزمائیں. |
| 500 یا 502 | دور دراز عمل قبول ہو چکا ہو سکتا ہے. مقامی عملی غلطی میں requestId شامل ہو سکتا ہے. اسے محفوظ کریں اور موجودہ وسیلہ جانچیں; متبادل رجسٹریشن ضروری نہ سمجھیں. |