Elérhető mobilszámok keresése

Ellenőrizze, hogy a mobilszámkészlet engedélyezve van-e

Csak akkor használja ezt a keresést, ha az ügyfélfiókjához már engedélyezték a mobilszámkészletet. A fiók felderítési folyamatával kérjen le egy aktuális, egyedi mobil-előtagot. A támogatott útvonal ehhez az előtaghoz kér le mobilhálózati számkészletet. Nem függ egy megfelelő, vezetékes útválasztási metaadatokat tartalmazó rekordtól. Forduljon az ügyfélszolgálathoz, ha nem biztos abban, hogy a fiókja vagy az előtagja engedélyezve van-e.

A jelenlegi örökölt útvonal nem utasít el megbízhatóan minden jogosulatlan kérést. Egy olyan fiók is kaphat általános számkészletet, amelynél nincs engedélyezve a mobilszámkészlet, miközben a válaszban továbbra is ez szerepel: info.is_mobile: 1. Egy díjmentesen hívható számokhoz tartozó előtag is elérheti ezzel a jelöléssel a díjmentes számkészletet kezelő ágat. Ne azonosítsa a mobilszolgáltatást kizárólag e jelölés alapján, és ne küldjön általános vagy díjmentesen hívható számokhoz tartozó előtagokat erre a végpontra. Használja a fiók megerősített mobilkatalógusát és az engedélyezett munkafolyamatot.

Minden számot a hozzá tartozó árválasztékkal együtt kezeljen

Minden felkínált számnál tartsa együtt a következőket: number, info.uuid és az ugyanahhoz a bejegyzéshez tartozó price lista. A válasz az előtagra, a területre és az országra vonatkozó metaadatokat, szerződési feltételeket és regisztrációs korlátozásokat is tartalmaz. A felkínált számok az első áropciójuk havi díja szerint növekvő sorrendben szerepelnek; azonos árak esetén nem garantált az állandó sorrend. Ne helyettesítse a visszaadott számazonosítót terület- vagy előtagazonosítóval, és ne párosítsa másik felkínált szám árazonosítójával.

A teljes válasz további metaadatokat és ármezőket is tartalmazhat. A visszaadott features, a csatornaértékek és a restrictions a felkínált számot írják le; nem garantálják, hogy a hívás, az SMS, az MMS vagy a fax már használható. A fiók jogosultságai, a regisztráció és a kiválasztott díjcsomag továbbra is meghatározóak. A példában szereplő helyőrzőket ne tekintse érvényes azonosítóknak vagy áraknak.

Kis pozitív mennyiséget használjon

Kezdjen 1 mennyiséggel. A szokásos szolgáltatói kérés a nem pozitív mennyiséget 1 értékre módosítja, és a szolgáltatónak küldött értéket 300 értékben korlátozza, de a későbbi eredménykezelés továbbra is az eredeti bemenetet használja. A nulla mennyiség ezért kiválthat készletlekérést a szolgáltatótól anélkül, hogy bármilyen felkínált számot visszaadna. Más örökölt ágak nem érvényesítik következetesen a kért eredményszámot. Ne támaszkodjon egyetlen általános felső határra, és ne küldjön negatív, tört vagy nem numerikus értékeket. Ehhez az útvonalhoz nincs dokumentált, támogatott nyilvános keresési szűrő vagy a kérés törzsében megadható árazonosító-paraméter.

Különböztesse meg a készlethiányt a lekérdezési hibától

A 404 válasz jelenthet nem elérhető készletet, letiltott szolgáltatást, sikertelen beszállítói lekérdezést vagy érvénytelen katalógusrekordokat. Időtúllépés vagy szolgáltatói hiba esetén tekintse az elérhetőséget ismeretlennek, ne pedig igazoltan nulla készletnek. Frissítse a kiválasztást, és szükség esetén növekvő várakozási időkkel próbálkozzon újra. Kerülje az összes telefonközponti előtag ismételt lekérdezését. A mobilszámkészlet darabszámát lekérő külön végpont egy pillanatnyi tájékoztató értéket ad, amelynek nem kell megegyeznie az adott fiókhoz felkínált számok listájának hosszával.

Vásárlás előtt ellenőrizze újra

A keresés nem foglal le készletet. A felülvizsgált ág megpróbálja kizárni a már megvásárolt számokat, de a helyi foglalások sikertelen lekérdezése esetén ilyen szám is az eredmények között maradhat. A vásárlási folyamatnak ellenőriznie kell az elérhetőséget, a tulajdonjogot, a jóváhagyott árakat és a regisztrációt. Az ellenőrzésekkel védett vásárlási kéréshez használjon friss kiválasztást, és bizonytalan vásárlási eredmény után az újrapróbálkozás előtt egyeztesse a fiók számkészletét. Soha ne vásároljon pusztán azért, mert a keresés felkínált egy számot.

Kérés

Engedélyezett API-fiókot használjon HTTPS-kapcsolaton, engedélyezett forrás-IP-címről. Az ügyfélfiókhoz a mobilszámkészletet is engedélyezni kell; az API-hitelesítés önmagában nem engedélyezi azt.

Küldjön GET kérést az aktuális egyedi előtag azonosítójával és egy pozitív egész mennyiséggel az URL elérési útjában. Ha a mennyiség hiányzik, az alapértelmezett érték 1. Használja a példát 1 mennyiséggel; ez az útvonal nem ellenőriz és nem érvényesít következetesen egy általános eredménykorlátot.

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

Útvonalparaméterek
Név	Típus	Kötelező	Leírás
`prefix_id`	string	Igen	A felderítéssel kapott, jogosult egyedi mobil-előtag látható azonosítója, amelynek tartalmát nem szabad értelmezni. A fiókja által támogatott mobil NPA/NXX telefonközponti előtagot használjon; ne helyettesítse területazonosítóval, csoportos megjelenítési azonosítóval, szó szerinti tárcsázási előtaggal vagy díjmentesen hívható számok előtagjával.
`quantity`	integer	Nem	A felkínált számok kért darabszáma. Alapértelmezett értéke 1. Adjon meg egy nem túl nagy pozitív egész számot. A szokásos szolgáltatói kérés 300 értékben korlátozza a mennyiséget, de ez nem jelent általános bemenetellenőrzést vagy garanciát a válasz méretére.

Válasz

A HTTP-állapot mellett ellenőrizze a JSON-törzsben a status.code és a status.msg mezőt is. Siker esetén a response a felkínált számok listája, a status.msg értéke Results:, amelyet a visszaadott számok darabszáma követ, a status.results pedig a szerializált lista hossza. A felkínált számok árai fiókonként eltérőek. A rövidített szemléltető példa tényleges készlet vagy díjajánlat helyett helyőrzőket használ. A számok pluszjel nélkül tartalmazzák az országkódot; az azonosítók olyan karakterláncok, amelyek tartalmát nem szabad értelmezni.

A válasz szerkezetét szemléltető példa; nem élő fiókadat és nem aktuális árajánlat.

{
  "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"
      ]
    }
  ]
}

Hibák

404: Érvénytelen előtagazonosító, ország vagy terület: frissítse az egyedi mobil-előtag kiválasztását.
404: Nem találhatók számok: jelenthet felhasználható készlet hiányát, letiltott szolgáltatást, sikertelen szolgáltatói lekérdezést, nem támogatott kiválasztást vagy fiókkorlátozásokat. Nem bizonyítja hitelesen, hogy a készlet darabszáma nulla.

Elérhetőség és mellékhatások

A keresés nem bérel és nem foglal le számot, a felülvizsgált útvonal pedig nem terhel vásárlási összeget a fiókra. Kapcsolatba lép a számkészlet szolgáltatójával, és időt vehet igénybe.
A sikeres keresések a fiókhoz kapcsolódó szám- és árbejegyzéseket írnak a gyorsítótárba, és lekérdezési naplókat rögzítenek. A keresés megismétlése nem jelent foglalást, árrögzítést vagy vásárlást.
A visszaadott árakat, feltételeket, korlátozásokat és képességeket a kiválasztott fiók és szám szempontjából kell áttekinteni. Egy funkciójelölés nem igazolja az aktiválást, az üzenetküldés jóváhagyását vagy a szolgáltatás tesztelt működőképességét.