CNAM integrācija
CNAM REST API atsauce
Pieprasiet zvanītāja vārdu, izmantojot HTTPS, un apstrādājiet rezultātu, maksu un kļūdas.
Izvēlieties uzziņas darbības veidu
| Līmenis | Publiskā cena par vaicājumu | Ko tas dara |
|---|---|---|
| Starter | 0,0026 $ | Izmanto pašu rīcībā esošus un kešatmiņā saglabātus zvanītāju vārdu datus. |
| Standard | 0,0037 $ | Veic reāllaika tīkla meklēšanu katram vaicājumam. |
| Mixed | 0,004 $ | Vispirms mēģina veikt uzziņu tīklā reāllaikā un pēc tam izmanto Starter datus, ja vārds nav atrasts. |
Izvēlētais pakalpojums nosaka uzziņas darbības veidu; Mixed nav uzziņa, kas vispirms izmanto kešatmiņu. Pirms lietošanas reālajā vidē pārbaudiet kontam piešķirto tarifu. Zvanītāja vārds nav identitātes vai īpašumtiesību pierādījums.
Nosūtiet autentificētu uzziņas pieprasījumu
Galapunkts: GET https://api.multitel.net/v3/cnam/NUMBER. Izmantojiet tālruņa numurus starptautiskajā formātā, tikai ar cipariem un iekļaujot valsts kodu, bez pieturzīmēm un sākuma pluszīmes. Izpildiet pieprasījumu no sava lietojumprogrammas servera, izmantojot apstiprinātus API akreditācijas datus.
curl --fail-with-body \
--user "$MULTITEL_API_USERNAME:$MULTITEL_API_PASSWORD" \
--header "Accept: application/json" \
"https://api.multitel.net/v3/cnam/12025550123"Norādiet abus vides mainīgos, izmantojot servera puses slepeno datu konfigurāciju. Nodrošināti bearer akreditācijas dati ir alternatīva tikai tad, ja šī piekļuve ir iespējota un ir izpildīti tās avota IP ierobežojumi. Nekad neiekļaujiet API slepenos datus publiskā pārlūkprogrammas koda paketē.
Lasiet JSON atbildi
Šī atbilde ir ilustratīva. Atgrieztais vārds un maksa ir atkarīgi no uzziņas un izvēlētā pakalpojuma.
{
"status": {
"code": 200,
"msg": ""
},
"response": {
"number": "12025550123",
"name": "EXAMPLE CALLER",
"cost": "0.004",
"balance": "24.9960"
}
}status.code- Lietojumprogrammas rezultāta kods; pirms salīdzināšanas ar 200 normalizējiet virknes un skaitliskās vērtības.
status.msg- Pievienotais rezultāta vai noraidījuma ziņojums.
response.number- Vaicātais numurs.
response.name- Pieejamais zvanītāja vārds.
response.cost- Šim vaicājumam uzrādītā maksa; apstrādājiet to kā decimālu naudas summu.
response.balance- Uzrādītais konta atlikums, ja tas ir pieejams.
Rezultāti bez vārda un kļūdas
Veiksmīgs pieprasījums negarantē izmantojamu zvanītāja vārdu. Apstrādājiet tukšu vārdu, vārda vietā atgrieztu numuru un noraidītu uzziņu. Lietojumprogrammas kods 403 var norādīt uz nepietiekamu kredītu, aizliegtu pirkumu vai numuru bez rezultāta; pārbaudiet ziņojumu.
Pirms piekļuves response.name pārbaudiet gan HTTP statusu, gan JSON status. Kļūdas gadījumā atbildes objekta var nebūt. Trūkstošs vārds nedrīkst bloķēt parasta zvana maršrutēšanu.
Norēķini, atkārtoti mēģinājumi un atšķirība no zvanītāja ID atjaunināšanas
Jauna uzziņa var radīt maksu par vaicājumu. Šīm uzziņu saskarnēm nav dokumentēta idempotences atslēga, tāpēc jauns mēģinājums var būt otrs maksas vaicājums. Datu pārsūtīšanas vai pakalpojuma kļūmju gadījumā izmantojiet ierobežotu skaitu atkārtotu mēģinājumu ar pieaugošu aizkavi, vispirms novērsiet konta kļūdas un salīdziniet uzrādītās vaicājumu maksas. Glabājiet datus kešatmiņā tikai lietojumprogrammai piemērotu laiku; zvanītāju vārdu dati var mainīties.
CNAM uzziņa nolasa vārdu. Tā nemaina vārdu, kas tiek parādīts jūsu izejošajos zvanos. Zvanītāja vārda atjaunināšana LIDB ir atsevišķa darbība ar saviem laukiem, autorizāciju, cenu un apstrādi.