Përdorni dokumentacionin aktual
Hapni Dokumentacionin API pasi të hyni në llogari. Aty gjenden endpoint-et, fushat dhe shembujt e mbështetur. Ky udhëzues shpjegon rrjedhën e punës pa kopjuar specifikimin.
Përgatitni çelësin
Ndiqni verifikimin e identitetit për të parë ose kopjuar çelësin. Dokumentacioni lejon pesë minuta qasje të verifikuar për çelësin dhe Playground; krijimi ose rigjenerimi kërkon verifikim të ri. Ruajeni çelësin si fjalëkalim: në serverin e aplikacionit, jo në depo publike kodi, kod shfletuesi apo pamje ekrani.
Bëni kërkesën e parë
- Hapni Playground dhe zgjidhni një kërkesë vetëm për lexim, si lista e identiteteve SIP.
- Kontrolloni metodën, adresën dhe parametrat. Përdorni identifikues të llogarisë suaj, jo vlerat shembull.
- Zgjidhni ekzekutimin e kërkesës dhe lexoni statusin HTTP dhe përmbajtjen e përgjigjes.
- Përdorni shembullin e dokumentuar në aplikacionin tuaj duke ruajtur kredencialet në mënyrë të sigurt.
Playground përdor llogarinë tuaj reale. Dërgimi i mesazheve, thirrjet dhe porositë mund të kryejnë veprime reale me pagesë. Nuk është mjedis testimi falas.
Shtoni njoftimet webhook
Te integrimet e llogarisë shtoni endpoint HTTPS dhe zgjidhni ngjarjet. Sekreti i nënshkrimit webhook është i ndryshëm nga çelësi API. Verifikoni nënshkrimet, përpunoni çdo ngjarje vetëm një herë dhe konfirmoni marrjen shpejt. Kontrolloni regjistrin e dërgesave për probleme. Para përsëritjes së një veprimi me pagesë lexoni rregullat API për riprovim dhe kërkesa të dyfishta; skadimi i pritjes nuk provon se veprimi dështoi.
Udhëzues të lidhur
Zgjidhni dokumentacionin e shërbimit
Dokumentacioni ndan Lookup, Pricing, SIP, SMS, Contacts, Speech API, Phone Numbers, Voice API dhe Calls & recordings. Kontrolloni endpoint-in për kushtet, fushat dhe tarifat. Telefonimi në shfletues ka udhëzuesin Webphone SDK; nuk është i njëjtë me kontrollin e thirrjeve Voice API nga serveri.
Leja e agjentit për lexim të dokumentacionit nuk jep çelësin API të pronarit ose ekzekutimin Playground me atë çelës. Kërkojini pronarit të menaxhojë kredencialet, jo të ndajë hyrjen e tij.
Përdorni referencat dhe faqëzimin
Referencat publike kopjohen të plota: përdorni CALL- nga përgjigjja juaj, jo vlerë të ndërtuar ose identifikues të brendshëm telefonik. Historiku dhe thirrjet aktive janë lista të ndryshme. Veprimi i kontrollit kërkon edhe gjendje të mbështetur; një rresht historiku nuk është domosdoshmërisht i kontrollueshëm.
Për historikun ndiqni pagination.next_cursor sa kohë pagination.has_more është true. Mbani të njëjtët filtra days, limit dhe identitet SIP. Mos deshifroni ose ndryshoni cursor-in. Kur skadon, filloni listim të ri dhe krahasoni me referencën publike. Koha e dokumentuar si UTC duhet konvertuar qëllimisht për shfaqje; nuk është automatikisht ora lokale e shfletuesit.
Trajtoni gabimet pa veprime të dyfishta me pagesë
Lexoni statusin HTTP bashkë me gabimin e strukturuar. Korrigjoni validimin ose autorizimin para riprovimit. Respektoni pritjen e dokumentuar për kufirin e kërkesave. Për skadim pritjeje ose gabim të përkohshëm në veprim me pagesë, kontrolloni statusin dhe rregullat kundër përsëritjes para dërgimit tjetër; ndryshimi i identifikuesve mund të krijojë veprim të ri. Mbani referencën publike, kohën dhe gabimin pa sekrete për Mbështetjen, kurrë çelësin API.