Hero SMS numaraları

Hero SMS numaraları geçicidir. Bir ülke ve bir servis seçersiniz, yaklaşık 20 dakikalığına bir numara kiralarsınız, doğrulama SMS’ini alırsınız ve numarayı bırakırsınız. Tek bir kayıt ya da doğrulama için numara almanın en ucuz yoludur.

Twilio’nun aksine numaralara önceden tek tek göz atamazsınız. Bir ülke ve bir servis seçer, fiyat ve stoğa bakar, kiralarsınız.

1. Ülkeyi ve servisi bulun.

   curl https://api.clearance.rest/numbers/providers/herosms/countries \
     -H "X-API-Key: $CLEARANCE_REST_API_KEY"
   
   curl "https://api.clearance.rest/numbers/providers/herosms/services?country=6" \
     -H "X-API-Key: $CLEARANCE_REST_API_KEY"

   Bir ülkenin id’si (örneğin Endonezya için 6), diğer endpoint’lerin country olarak aldığı değerdir. Bir servisin code’u (örneğin tg), service olarak verdiğiniz değerdir.

2. Fiyat ve stoğa bakın (isteğe bağlı).

   curl "https://api.clearance.rest/numbers/providers/herosms/prices?country=6&service=tg" \
     -H "X-API-Key: $CLEARANCE_REST_API_KEY"

   { "success": true, "prices": { "country": 6, "service": "tg", "cost": 0.2, "count": 1500, "physicalCount": 40 } }

   cost gösterge niteliğindedir, garanti edilmiş bir taban fiyat değildir.

3. Bir numara kiralayın.

   curl

   curl -X POST https://api.clearance.rest/numbers/providers/herosms/rent \
     -H "X-API-Key: $CLEARANCE_REST_API_KEY" \
     -H "content-type: application/json" \
     -d '{ "service": "tg", "country": 6 }'

   Node.js

   const { number } = await clearanceRest.numbers.rent({ service: 'tg', country: 6 });
   console.log(number.phoneNumber, number.expiresAt);

   PHP

   $number = $client->numbers->rent(service: 'tg', country: 6)['number'];

4. Numarayı kullanın, sonra SMS’i bekleyin.

   number.phoneNumber’ı doğrulamanın tetiklendiği yere girin, sonra SMS’i bekleyin.

5. Bırakın.

   curl -X POST https://api.clearance.rest/numbers/release \
     -H "X-API-Key: $CLEARANCE_REST_API_KEY" \
     -H "content-type: application/json" \
     -d '{ "sid": "c1aaeac1-ec52-44e2-b00a-d1350fb6bee6" }'

Birden fazla numara kiralama

quantity gönderin (1 ile 20 arası). Yanıt o zaman her zaman, aktivasyon başına bir sonuç içeren bir numbers dizisidir. Birinin başarısız olması diğerlerini durdurmaz.

{
  "success": true,
  "numbers": [
    { "success": true, "number": { "sid": "c1aaeac1-…", "phoneNumber": "+6281234567890" } },
    { "success": false, "error": "hero-sms NO_NUMBERS" }
  ]
}

max_price’ı vermeyin

max_price basit bir fiyat tavanı gibi görünür, ama Hero SMS’te aynı zamanda pazar yeri stoğuna erişimi de belirler. Vermezseniz servis gösterge fiyattan başlar ve stok bulana kadar tavanı büyüterek yeniden dener; bunu sizin yapmanıza gerek kalmaz. max_price göndermek bunu devre dışı bırakır ve tam bir kez dener; bu yüzden yalnızca kesin bir bütçe tavanına ihtiyacınız varsa ve bir NO_NUMBERS hatasını kabul edebiliyorsanız gönderin.

Diğer isteğe bağlı filtreler: operator (GET /providers/herosms/operators’tan) ve phone_exception (hariç tutulacak numara önekleri, virgülle ayrık, en fazla 20).

Ömür

Kiralama yaklaşık 20 dakika sürer (numaradaki expiresAt). Bittiğinde numara kısa bir süre EXPIRED, sonra RELEASED olur ve artık SMS alamaz. Zaten aldığı SMS’ler GET /sms/wait ile okunabilir kalır.

Bırakma ve iade

POST /numbers/release, SMS geldiyse aktivasyonu tamamlar; gelmediyse iptal eder (ve size iade eder).

Hero SMS, kiralamadan sonraki yaklaşık ilk iki dakikada iptali reddeder. Bu pencerede release, daha sonra tekrar denemenizi isteyen bir hata döndürür. Hiçbir şey yapmazsanız kiralama süresi dolduğunda otomatik olarak iptal edilir ve iade edilir.

SMS’i yeniden isteme

SMS gelmediyse Hero SMS’ten tekrar göndermesini isteyin:

curl -X POST https://api.clearance.rest/numbers/providers/herosms/resend \
  -H "X-API-Key: $CLEARANCE_REST_API_KEY" \
  -H "content-type: application/json" \
  -d '{ "sid": "c1aaeac1-ec52-44e2-b00a-d1350fb6bee6" }'

En ucuz seçeneği kiralama (SDK)

SDK’lar fiyata bakmayı ve kiralamayı tek çağrıda yapabilir. Stokta hiçbir şey yoksa kiralamadan hata verir:

const { number } = await clearanceRest.numbers.rentCheapest({ service: 'tg', country: 6 });