Găsiți numere mobile disponibile

Confirmați că inventarul mobil este activat

Utilizați această căutare numai după ce inventarul de numere mobile a fost activat pentru contul dumneavoastră de client. Obțineți un prefix mobil individual actual prin fluxul de lucru de descoperire al contului. Calea acceptată solicită inventarul wireless pentru acel prefix. Nu depinde de o înregistrare corespunzătoare de metadate de rutare pentru rețeaua fixă. Contactați asistența dacă nu sunteți sigur dacă contul sau prefixul dumneavoastră este activat.

Ruta moștenită actuală nu respinge în mod fiabil fiecare cerere neeligibilă. Un cont fără inventarul mobil activat poate primi inventar obișnuit, în timp ce răspunsul încă prezintă eticheta info.is_mobile: 1. Un prefix gratuit poate ajunge, de asemenea, în ramura de inventar pentru numere gratuite cu acea etichetă. Nu folosiți doar această etichetă pentru a identifica serviciul mobil și nu trimiteți prefixe obișnuite sau gratuite către acest punct final. Utilizați catalogul mobil confirmat al contului și fluxul de lucru activat.

Păstrați fiecare număr împreună cu propria sa selecție de preț

Pentru fiecare candidat, păstrați number împreună cu info.uuid și cu lista price a aceleiași intrări. Răspunsul conține, de asemenea, metadate de prefix/zonă/țară, termeni contractuali și restricții de înregistrare. Candidații sunt sortați după prețul lunar al primei opțiuni de preț, în ordine crescătoare; nu există o ordine stabilă garantată pentru prețuri egale. Nu înlocuiți ID-ul numărului returnat cu un ID de zonă sau de prefix și nu îl asociați cu ID-ul de preț al altui candidat.

Răspunsul complet poate include câmpuri suplimentare de metadate și de preț. Valorile returnate features, valorile canalelor și restrictions descriu candidatul; nu constituie o garanție că apelurile, SMS, MMS sau faxul sunt deja utilizabile. Permisiunile contului, înregistrarea și planul de serviciu selectat rămân aplicabile. Nu tratați marcajele substitutive din exemplu ca ID-uri sau prețuri valide.

Utilizați o cantitate mică pozitivă

Începeți cu o cantitate de 1. Cererea normală către furnizor normalizează o cantitate nepozitivă la 1 și limitează valoarea upstream la 300, dar tratarea ulterioară a rezultatelor folosește în continuare datele de intrare originale. O cantitate zero poate, prin urmare, să solicite inventarul upstream și să nu returneze niciun candidat. Alte ramuri moștenite nu impun în mod constant numărul solicitat de rezultate. Nu vă bazați pe un singur maxim universal și nu trimiteți valori negative, fracționale sau nenumerice. Pentru această rută nu este documentat niciun filtru public de căutare acceptat și niciun parametru de corp cu ID de preț.

Distingeți lipsa stocului de eșecul căutării

Un răspuns 404 poate reprezenta inventar indisponibil, serviciu dezactivat, o căutare eșuată la furnizor sau înregistrări de catalog nevalide. Tratați un timeout sau un eșec al furnizorului ca disponibilitate necunoscută, nu ca stoc zero confirmat. Reîmprospătați selecția și reîncercați cu backoff atunci când este cazul. Evitați să interogați repetat fiecare centrală. Punctul final separat de numărare a inventarului mobil este o indicație de tip instantaneu și nu trebuie să corespundă lungimii listei de candidați a acestui cont.

Verificați din nou înainte de cumpărare

Căutarea nu rezervă stoc. Ramura revizuită încearcă să excludă numerele deja cumpărate, dar o căutare locală de rezervare eșuată poate lăsa un asemenea candidat în rezultat. Disponibilitatea, proprietatea, prețurile aprobate și înregistrarea trebuie verificate de fluxul de lucru de cumpărare. Utilizați o selecție proaspătă cu cererea de cumpărare protejată și reconciliați inventarul contului după orice rezultat de cumpărare incert înainte de a reîncerca. Nu cumpărați niciodată doar pentru că a fost returnat un candidat.

Cerere

Utilizați un cont API activat prin HTTPS de la o adresă IP sursă permisă. Inventarul mobil trebuie, de asemenea, să fie activat pentru contul de client; autentificarea API singură nu îl activează.

GET cu identificatorul actual al prefixului individual și o cantitate întreagă pozitivă în calea URL. Cantitatea este implicit 1 dacă este omisă. Utilizați exemplul cu 1; această rută nu validează și nu impune în mod constant o limită universală de rezultate.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/getmobiles/$PREFIX_ID/1"

Răspuns

Inspectați status.code și status.msg în corpul JSON, precum și starea HTTP. În caz de succes, response este o listă de candidați pentru numere, status.msg are valoarea Results: urmată de numărul de elemente returnate, iar status.results reprezintă lungimea serializată a listei. Prețurile candidaților sunt specifice contului. Exemplul ilustrativ abreviat folosește marcaje substitutive în locul unui inventar real sau al unei cotații tarifare. Numerele conțin codul de țară fără semnul plus; identificatorii sunt șiruri opace.

Formă ilustrativă a răspunsului; nu sunt date reale ale contului și nici o ofertă de preț actuală.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

Erori

• 404: ID de prefix, țară sau zonă nevalidă: reîmprospătați selecția prefixului mobil individual.
• 404: Nu au fost găsite numere: poate însemna lipsa unui stoc utilizabil, un serviciu dezactivat, o căutare eșuată la furnizor, o selecție nesuportată sau limitări ale contului. Nu este dovada unei numărători autoritative de inventar zero.

Disponibilitate și efecte secundare

• Căutarea nu închiriază și nu rezervă un număr, iar calea revizuită nu debitează o sumă de cumpărare. Contactează furnizorul de inventar și poate dura.
• Căutările reușite scriu intrări de cache pentru numere și prețuri legate de cont, precum și jurnale de interogare. Repetarea unei căutări nu este o rezervare, o blocare a prețului sau o cumpărare.
• Prețurile, termenii, restricțiile și capabilitățile returnate trebuie revizuite pentru contul și numărul selectate. O etichetă de funcționalitate nu stabilește activarea, aprobarea mesageriei sau funcționalitatea testată a serviciului.