Claude Code ile SMS Doğrulama API'sini Kullanma: Kurulum Rehberi

Claude Code, SMS doğrulamasını projenize ekleyebilir: ona SMS Activate App API becerisini verin ve API anahtarınızı bir ortam değişkeninde tutun.

Claude Code, SMS doğrulamasını projenize sizin yerinize ekleyebilir: ona SMS Activate App API becerisini (skill) verin, API anahtarınızı bir ortam değişkeninde tutun ve para harcayan her adımı gözden geçirin.

Bu rehberle kurulumu yaklaşık on dakikada tamamlarsınız. Aynı yöntem Codex, Cursor ve dosya okuyup komut çalıştırabilen her kodlama ajanıyla da geçerlidir.

Ajan API ile neler yapabilir

Bir anahtarla kodlama ajanı, sizin kodunuzun yapabildiği her şeyi yapabilir:

  • Bir ülkedeki güncel numaraları aramak ve size uygulanan fiyatı görmek.
  • 28 günlük süreyle özel bir numara satın almak. Idempotency-Key sayesinde yeniden deneme sizden iki kez ücret almaz.
  • Numaraya gelen SMS'leri ve aramaları okumak. Kasım 2026'dan beri kısa bir arama, metniyle ve içinde sesli okunan kodla birlikte gelir.
  • Bir numarayı bırakmak veya yenilemesini kapatmak.
  • Kodların sunucunuza sorgulama yapmadan ulaşması için webhook kurmak.

Ajana devredebileceğiniz tipik işler: kayıt akışınızın uçtan uca testi, CI içinde kodu bekleyen bir yardımcı veya imza doğrulaması yapan bir webhook alıcısı.

1. Adım: Anahtar oluşturun ve koddan uzak tutun

  • Kayıt sayfasında bir hesap oluşturun ve bakiye ekleyin.
  • Hesabınızdaki API anahtarları sekmesinde veya Telegram botunda kişisel bir API anahtarı oluşturun.
  • Anahtarı kabuğunuza (shell) veya projenizin secret deposuna koyun. Ajanın commit edeceği bir dosyaya asla yazmayın:

Anahtar bakiyenizi harcar. Claude Code değişkeni komut çalıştırırken okur; değeri sohbette görmesi gerekmez. Anahtar bir dosyaya, commit'e veya loga düşerse hesabınızdan iptal edin ve yenisini oluşturun.

2. Adım: Claude Code'a beceriyi verin

Site, kodlama ajanları için hazır bir beceri dosyası yayımlar: /api-skill.md. Dosya temel URL'yi, rotaları, limitleri ve ele alınacak hataları içerir. Bunu proje becerisi olarak kaydedin:

Claude Code, bir görev beceri açıklamasıyla eşleştiğinde o beceriyi yükler. Örneğin “kayıt testimde SMS kodunu bekle” gibi bir görev. Ekibiniz de kullanacaksa beceri dosyasını commit edin; içinde anahtar yoktur.

Ajanınız beceri desteklemiyor mu? API belgelerini açın ve ajan istemini kopyalayan düğmeye basın. Aynı kurallar, herhangi bir sohbete yapıştırabileceğiniz tek bir metin bloğunda gelir.

3. Adım: Çalışma kurallarını belirleyin

Her oturumun uyması için projenizin CLAUDE.md dosyasına birkaç satır ekleyin:

En önemlisi ikinci kuraldır. Numara verildikten sonra satın alma kesindir ve iade edilmez, bu yüzden her alımı gerçekleşmeden önce bir kişi görmelidir. Claude Code komut çalıştırmadan önce izin ister; satın alma rotasını çağıran komutlar için bu izni açık tutun.

4. Adım: Ona bir görev verin

Tek tek API çağrılarını değil, sonucu isteyin. Örneğin:

SMS Activate App API üzerinden bir ABD numarası kiralayan, o numaraya gelecek SMS'i en fazla beş dakika bekleyen ve kodu döndüren bir pytest fixture'ı ekle. Her seferinde yeni numara almak yerine çalıştırmalar arasında yenilenen tek bir numarayı kullan.

İyi bir sonuç şöyle görünür:

  • GET /v1/public/numbers/search?country=US ile arama yapar ve satın almadan önce numarayı ve fiyatını size gösterir.
  • POST /v1/public/numbers isteğine bir Idempotency-Key ekleyerek satın alır.
  • GET /v1/public/numbers/{id}/sms rotasını zaman aşımıyla birlikte her 5 ila 15 saniyede bir sorgular veya webhook kurar.
  • insufficientbalance, numberunavailable ve rate_limited durumlarını çökme olarak değil, yanıt olarak ele alır.

Ajan beceride olmayan bir rota uydurursa onu OpenAPI dosyasına yönlendirin ve kontrol etmesini isteyin.

5. Adım: Birleştirmeden önce gözden geçirin

Ajanın yazdığını birleştirmeden önce dört noktayı kontrol edin:

  • Diff'te, test çıktısında ve CI loglarında anahtar yok.
  • Her satın alma bir Idempotency-Key gönderiyor ve yeniden deneme onu yeniden kullanıyor.
  • Her bekleme bir zaman aşımına ve numarayı belirten net bir hata mesajına sahip.
  • Yenilenen tek bir numara yeterliyken test her çalıştırmada yeni numara almıyor.

Bilmeniz gereken maliyetler

Her numara, aramanın gösterdiği fiyattan 28 günlüğüne kiralanır ve otomatik yenileme açık olduğu sürece bakiyenizden yenilenir. Kasım 2026'dan beri bir numaraya gelen aramalar (dakika başına) ve SMS'ler de bakiyenizden düşülür. Fiyat ülkeye göre değişir ve API bunu usagePricing olarak döndürür. Ajanın bir test takımını zamanlanmış çalıştırmasına izin vermeden önce güncel rakamlar için fiyatlandırma sayfasına bakın.

Ne zaman kullanılmaz

API SMS ve aramaları alır; göndermez. Kendi uygulamalarınız, hesaplarınız ve testleriniz için kullanın. Bir numarayı kabul edip etmeyeceğine, doğrulama yaptığınız platform karar verir, biz değil. Bu yüzden bir numara üzerine işlem hattı kurmadan önce numarayı hedef servisinizde deneyin: kiralamadan önce numara nasıl kontrol edilir.

Sonraki adımlar