Twilio numaraları

Twilio numaraları, bırakana kadar kiralayıp elinizde tuttuğunuz sanal numaralardır; dakikalarca süren Hero SMS numaralarının aksine. Her biri Twilio tarafından aylık faturalanır.

Bir numarayı kiralamak onu projenize ekler ve SMS webhook’unu clearance.rest’e yönlendirir; böylece gelen SMS’ler sizin tarafınızda hiçbir kurulum olmadan GET /sms/wait’e ulaşır.

Numara bulma

Numara kiralanabilen ülkeleri listeleyin:

curl https://api.clearance.rest/numbers/providers/twilio/countries \
  -H "X-API-Key: $CLEARANCE_REST_API_KEY"

Sonra bir ülkede arayın:

curl

curl "https://api.clearance.rest/numbers/providers/twilio/availables?country=US&sms=true&voice=true" \
  -H "X-API-Key: $CLEARANCE_REST_API_KEY"

Node.js

const { numbers } = await clearanceRest.numbers.availables({ country: 'US', sms: true });

PHP

$numbers = $client->numbers->availables(country: 'US', sms: true)['numbers'];

Parametre	Varsayılan
country (zorunlu)		ISO 3166-1 alpha-2 kodu, örneğin US, GB, TR.
sms	true	Yalnızca SMS alabilen numaralar.
mms	false	Yalnızca MMS alabilen numaralar.
voice	false	Yalnızca sesli arama alabilen numaralar.
type	Local	Local, Mobile, National ya da TollFree.

Her sonucun bir price değeri vardır; bu, o ülke ve tür için aylık kiralama fiyatıdır. Twilio numaraları tek tek fiyatlandırmaz, bu yüzden listedeki her numara için aynıdır. Twilio’nun o kombinasyon için fiyatı yoksa null olur.

Kiralama

Aramadan gelen phoneNumber’ı verin. Tek numara için phone_number, birden fazlası için phone_numbers gönderin.

curl

curl -X POST https://api.clearance.rest/numbers/providers/twilio/rent \
  -H "X-API-Key: $CLEARANCE_REST_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "phone_numbers": ["+14155550100", "+14155550101"] }'

Node.js

const result = await clearanceRest.numbers.rent({
  provider: 'twilio',
  phoneNumbers: ['+14155550100', '+14155550101'],
});

PHP

$result = $client->numbers->rent(provider: 'twilio', phoneNumbers: ['+14155550100', '+14155550101']);

Yanıtın şekli isteği izler:

• phone_number, { "success": true, "number": { … } } döndürür; kiralama başarısız olduysa 502 hatası verir.
• phone_numbers, numara başına bir kayıt içeren { "success": true, "numbers": [ … ] } döndürür. Numaralar paralel ve birbirinden bağımsız kiralanır; biri başarısız olursa diğerleri etkilenmez. Her kaydın success alanına bakın.

İkisini birden gönderirseniz phone_numbers önceliklidir ve phone_number yok sayılır.

Dönen sid, numarayı bırakmak için kullandığınız id’dir. Twilio’nun kendi PN… SID’i providerSid içindedir.

Not

Twilio numaralarında capabilities, Twilio’nun döndürdüğü gibi küçük harfli anahtarlar (voice, sms, mms, fax) kullanır.

Bırakma

POST /numbers/release numarayı Twilio hesabından siler. Bkz. Numaraları yönetme.