API להקצאת מספרי DID
חפשו, הזמינו, הגדירו, ושחררו מספרי טלפון וירטואליים ב-145 מדינות באופן פרוגרמטי. בנו ניהול מספרים ישירות לתוך האפליקציה שלכם — ללא צורך בלוח בקרה.
מה זו הקצאת DID?
הקצאת DID (חיוג ישיר פנימה) היא התהליך של רכישה פרוגרמטית של מספר טלפון מקומי אמיתי והגדרת היעד שאליו מגיעות שיחות למספר זה. במקום להתחבר ללוח בקרה כדי לקנות מספר, האפליקציה שלכם קוראת ל-API של Israelnumber כדי לחפש מספרים זמינים, להקצות אחד לחשבון שלכם, להגדיר את יעד ההעברה שלו, ולשחרר אותו כשאין בו יותר צורך — הכל תוך שניות, בכל קנה מידה.
הפניית נקודות קצה API
כל הקריאות משתמשות ב-HTTP POST. קבלו את ה-account_token שלכם מנקודת הקצה Login תחילה וכללו אותו, יחד עם ה-id של החשבון שלכם, בכל בקשה עוקבת. כתובת בסיס: https://newsip.israelnumber.com
| נקודת קצה | מה זה עושה | פרמטרים מרכזיים |
|---|---|---|
| POST /api/login/ | התחברות, קבלת id ו-account_token לכל הקריאות הבאות | username, password |
| POST /customer/did_crud/ | חיפוש DID-ים זמינים במדינה (action=list) | action, country_id, id, token |
| POST /customer/did_management/ | רכישה והקצאה של DID לחשבון שלכם (action=assign) | action, did_id, accountid, id, token |
| POST /customer/did_crud/ | רשימת כל ה-DID-ים שנרכשו בחשבון שלכם (action=purchase_list) | action, id, token |
| POST /customer/did_management/ | הגדרת העברת שיחות — תמיד, כשתפוס, לא רשום, או אין מענה | did_id, call_type, call_type_value, always, user_busy, user_not_registered, no_answer |
| POST /customer/did_management/ | שחרור DID והסרתו מהחשבון שלכם (action=release) | action, did_id, id, token |
תהליך מלא: חיפוש ← הזמנה ← הגדרה ← שחרור
דוגמת Python מלאה העוברת על כל מחזור החיים של ה-DID.
import requests
BASE = "https://newsip.israelnumber.com"
# ── 1. Login ────────────────────────────────────────────────
res = requests.post(f"{BASE}/api/login/",
data={"username": "YOUR_ACCOUNT_NUMBER", "password": "YOUR_PASSWORD"})
login_data = res.json()
account_id = login_data["id"]
token = login_data["account_token"]
# ── 2. List available numbers in France ─────────────────────
avail = requests.post(f"{BASE}/customer/did_crud/", data={
"action": "list",
"country_id": "FR",
"id": account_id,
"token": token
})
dids = avail.json()["dids"]
print(f"Found {len(dids)} French numbers")
# Print first 3 options
for d in dids[:3]:
print(f" {d['did_number']} ${d['monthly_cost']}/mo")
# ── 3. Assign the first available number ────────────────────
chosen_id = dids[0]["did_id"]
assign = requests.post(f"{BASE}/customer/did_management/", data={
"action": "assign",
"did_id": chosen_id,
"accountid": account_id,
"id": account_id,
"token": token
})
print("Assigned:", assign.json())
# ── 4. Set forwarding to an external (PSTN) number ──────────
fwd = requests.post(f"{BASE}/customer/did_management/", data={
"did_id": chosen_id,
"id": account_id,
"token": token,
"always": "+33612345678" # French mobile number, or SIP: user@domain
})
print("Forwarding configured:", fwd.json())
# ── 5. Later: list all your purchased numbers ────────────────
my_dids = requests.post(f"{BASE}/customer/did_crud/", data={
"action": "purchase_list",
"id": account_id,
"token": token
})
print("My numbers:", [d["did_number"] for d in my_dids.json()["dids"]])
# ── 6. Release the number when done ─────────────────────────
release = requests.post(f"{BASE}/customer/did_management/", data={
"action": "release",
"did_id": chosen_id,
"id": account_id,
"token": token
})
print("Released:", release.json())עוד מדריכי API
|
| ||||
|
|
שאלות נפוצות — API להקצאת DID
כיצד קונים מספר טלפון וירטואלי דרך API?
התחברו דרך ה-API כדי לקבל את ה-id והטוקן של החשבון שלכם. לאחר מכן קראו לנקודת הקצה DID Available List (/customer/did_crud/, action=list) עם מזהה המדינה הרצויה כדי לראות מספרים זמינים. השתמשו ב-DID Assign (/customer/did_management/, action=assign) עם ה-did_id של המספר שבחרתם כדי לרכוש ולהוסיף אותו לחשבון שלכם.
האם ניתן לשחרר מספר באופן פרוגרמטי כשאין בו יותר צורך?
כן. קריאה ל-/customer/did_management/ עם action=release וה-did_id מסירה מספר מהחשבון שלכם באופן מיידי. זה עוצר את החיוב עבור המספר הזה החל ממחזור החיוב הבא.
אילו סוגי יעדי העברה נתמכים?
נקודת הקצה DID Forward Setting תומכת בתנאים עבור תרחישי העברה תמיד, תפוס, לא רשום, ואין מענה, כאשר כל אחד מצביע ליעד call_type כמו שלוחה, מספר חיצוני, או כתובת SIP. ניתן לשנות את היעד בכל עת דרך ה-API.
באילו מדינות ניתן להקצות מספרים דרך API?
Israelnumber מציעה מספרים וירטואליים ב-145 מדינות. נקודת הקצה Get Country List מחזירה את ה-ID של כל מדינה, אותו אתם מעבירים לנקודת הקצה DID Available List כדי לראות מספרים הזמינים כרגע להקצאה באותה מדינה.
התחילו להקצות מספרים כבר היום
קבלו את מפתח ה-API החינמי שלכם וחפשו מספרים זמינים בכל אחת מ-145 המדינות.