Kiválasztott telefonszám megvásárlása

Válassza ki együtt a számot és az árat

Vásároljon meg egy konkrét számot az elérhető számok friss keresésének találatai közül. A szám azonosítójaként a kiválasztott bejegyzés info.uuid értékét használja, az ár azonosítójaként pedig ugyanezen bejegyzés egyik price[].uuid értékét. Az útvonal a teljes tárolt számot is elfogadja, de egy ország-, körzet- vagy előhívó-azonosító nem helyettesíti a szám kiválasztását.

A keresés vagy a mentett árazás lekérése nem foglalja le a számot, és nem rögzíti az árát. Ellenőrizze a kiválasztott bekötési díjat, havidíjat, a bejövő hívások percdíját, a díjban foglalt perceket és csatornákat, valamint a fiók vásárlási jogosultságait és regisztrációs követelményeit. Az áttekintett segédkomponensben a kezdeti alapösszeg a bekötési díj és a havidíj összege; a kiválasztott díjcsomag teljes, szolgáltatóspecifikus díjait és feltételeit külön meg kell erősíteni.

Küldjön ellenőrzésekkel védett vásárlási kérelmet POST metódussal

Használjon engedélyezett API-fiókot HTTPS-kapcsolaton, engedélyezett forrás-IP-címről. A következő parancs vásárlást hajt végre, nem árajánlatkérés vagy próbaüzem. Minden változót ugyanabból a friss szám- és árválasztásból állítson be. A felső korlátokat megadó mezők megőrzik a korábbi restore_quote_ előtagot; a jelenlegi portál is ezeket használja a konkrét számok ellenőrzésekkel védett megvásárlásához.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --data-urlencode "restore_quote_price_id=$PRICE_ID" \
  --data-urlencode "restore_quote_setup=$SETUP_PRICE" \
  --data-urlencode "restore_quote_monthly=$MONTHLY_PRICE" \
  --data-urlencode "restore_quote_per_minute=$PER_MINUTE_PRICE" \
  --data-urlencode "restore_quote_channels=$CHANNELS" \
  "https://api.multitel.net/v3/rentnumber/$NUMBER_ID/$PRICE_ID"

Használjon űrlapadatokat küldő POST kérést a példában látható módon. A segédkomponens JSON-adatokat és beállításokat tartalmazó burkolóstruktúrákat is képes feldolgozni, de ez az áttekintés nem igazolta a teljes működésbeli azonosságot az összes ajánlatkezelési és szolgáltatói feldolgozási ágon. Vásárláshoz ne használjon GET kérést, még akkor sem, ha ez a korábbi koordinátor nem végez kifejezett metódusellenőrzést.

Az ajánlat árazonosítójának megadásakor mindig adja meg az ajánlat összes numerikus mezőjét is. A megváltozott azonosító, a felső korlátot meghaladó ár, a hiányzó vagy érvénytelen korlát, a megváltozott csatornaszám vagy a foglalt ajánlatzár 409 API-kódot eredményez, még mielőtt a kérés továbbításra kerülne a kiválasztott számbérbeadási szolgáltatónak. Az összehasonlítások kis lebegőpontos tűrést engednek meg; a díjcsomag ténylegesen megjelenített értékeit használja kézzel kerekített ár helyett.

Az ellenőrzések nem teszik a teljes munkafolyamatot próbaüzemmé vagy tranzakcióvá. A regisztrációs adatok lekérése, az identitás létrehozása vagy más segédműveletek ezen ellenőrzések előtt is megtörténhetnek. Az ellenőrzések a külső számkészletet sem rögzítik, és nem helyettesítik a fiókszintű vásárlási korlátozásokat.

Regisztráció és aktiválás

Ha szükséges, adja hozzá a RegistrationID űrlapmezőt, amely az ügyfél tulajdonában lévő regisztrációs profil UUID-jét tartalmazza. Ez nem egy feltöltött igazoló dokumentum, egy szolgáltatói cím vagy egy külön identitásentitás azonosítója. A segédkomponens a hitelesített fiók alapján oldja fel a profilt, és elutasítja a hiányzó vagy nem elérhető profilokat.

A támogatott számkészlet egy része lehetővé teszi a vásárlást a regisztráció befejezése előtt; más része a vásárlás előtt profilt követel meg. Továbbra is szükség lehet hálózati szolgáltatótól függő ellenőrzésre vagy szolgáltatásbeállításra. A sikeres vásárlást vagy az előzetes ellenőrzés elmaradását ne értelmezze a regisztráció alóli mentességként vagy azonnali aktiválásként.

Ha szerepel a válaszban, a registration_requirements mező az ország és a számtípus alapján végzett strukturált követelménylekérdezést azonosítja. Az alkalmazandó követelmények teljesítéséhez használja a regisztrációs katalógust és az igazoló dokumentumok munkafolyamatát. A visszaadott szöveg és metaadatok önmagukban nem jelentik a profil jóváhagyását.

Kerülje el a díjcsomag észrevétlen lecserélését

A korábbi koordinátor a gyorsítótárazott számadatokból kikövetkeztetheti a meg nem adott árat. Ha egy kifejezetten megadott árazonosító már nem létezik, egy gyorsítótárazott előhívóhoz tartozó legújabb fiókárra is visszaállhat, és frissítheti a gyorsítótárazott engedélyezett árválasztást. Ne hagyatkozzon ezekre a tartalék megoldásokra az ügyfél által jóváhagyott díjcsomag kiválasztásához.

Adja meg kifejezetten a kiválasztott árat és a hozzá tartozó ajánlatellenőrzési mezőket. Az ajánlatazonosító ellenőrzése még a bérlési kérés továbbítása előtt elutasítja a másik azonosítóra történő visszaállást. Elavult ár miatti ütközés után frissítse a keresést, és kérje az új választás jóváhagyását; ne távolítsa el az ellenőrzéseket a vásárlás kikényszerítéséhez.

Nincs minden feldolgozási ágra garantált foglalási időszak vagy általánosan érvényesített gyorsítótár-élettartam. A munkafolyamat újra ellenőrzi a szám elérhetőségét, a fiók árkorlátait és a vásárlási szabályokat, de a teljes szolgáltatóspecifikus működés áttekintése még folyamatban van.

Haladó beállítások: a fiók alapértelmezett útválasztása

A vásárlás örökölheti a fiók meglévő hanghívási céljait, tartalék céljait, SMS-célját és a hívásindítási trönkre vonatkozó preferenciáját. Rendelés előtt tekintse át ezeket az alapértékeket; az útválasztási beállítások elhagyása nem garantálja, hogy a szám konfigurálatlan lesz. Az áttekintett segédkomponens alapértelmezés szerint engedélyezi az automatikus megújítást.

Ezek a közös segédkomponens működési szabályai, és nem garantálják, hogy minden szolgáltató minden opcionális beállítást azonos módon ment. Léteznek további, korábbi hanghívási, hangposta-, fax- és SMS-mezők is, de ezek teljes szolgáltatóspecifikus áttekintése még szükséges. Mielőtt a hívások vagy üzenetek működésére hagyatkozna, a fiók munkafolyamatán keresztül ellenőrizze a megvásárolt szám mentett konfigurációját.

Válasz

Kitalált példa egy egyszerű vásárlásra; az értékek és a funkciók a kiválasztott díjcsomagtól függően eltérnek.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550123",
    "price": {
      "per_minute": "0.0100",
      "free_minutes": "100",
      "setup_price": "2.00",
      "monthly_price": "4.00",
      "channels": "2",
      "overflow": "0"
    },
    "features": [
      "voice"
    ],
    "needs_registration": 0,
    "registration_requirements": null
  }
}

A koordinátor a saját status.code/status.msg és response burkolóstruktúráját használja, és nem garantálja a status.results mező meglétét. Hiba esetén a válaszlista általában üres. Siker esetén vizsgálja meg a visszaadott számot és árat, majd egyeztesse a fiók számállományát és a regisztráció állapotát. A szolgáltató általi elfogadás nem jelent éles hanghívás-, SMS- vagy faxtesztet.

Hibák és bizonytalan eredmények

A HTTP-állapot mellett olvassa el az API tényleges választestét is. Egy külső szolgáltató már elfogadhatja a bérlést, mielőtt a helyi értesítés, a regisztráció vagy más feldolgozási lépés hibába ütközik. Egyes helyi számkészletből történő kiosztások adatbázis-tranzakciókat használnak, de a külső szolgáltatói megrendelésekre nincs általános visszagörgetés. Ez a koordinátor nem biztosít ügyféloldali idempotenciakulcsot.

Újrapróbálkozás előtt egyeztesse az állapotot

1. Az egyszeri beküldés előtt mentse el a jóváhagyott számot, árat és az ajánlat felső korlátait az alkalmazása rendelési rekordjában.
2. A kérés után kérje le ugyanannak a fióknak a megvásárolt számállományát és a szám részletes adatait, időtúllépés vagy hiba esetén is.
3. Ha a szám szerepel az állományban, újabb vásárlási kérés indítása helyett ellenőrizze az árát, megújítását, útválasztását és regisztrációs állapotát.
4. Ha az eredmény továbbra is bizonytalan, az újrapróbálkozás előtt kérje meg az ügyfélszolgálatot a szolgáltatói megrendelés és a fiók számlázásának egyeztetésére. Egy hibaüzenet vagy egy korábbi napló sikerjelzője önmagában nem elegendő bizonyíték.
5. A tulajdonjog és az aktiválás megerősítése után végezze el a fiók szokásos útválasztási ellenőrzéseit és szolgáltatástesztjeit.