Şirket Adından Domain ve Logo API’si

Şirket adından domain API’si hangi sorunu çözer?

Şirket adı insanlar için kullanışlı, veritabanı anahtarı olarak ise güvenilmezdir. Adlar paylaşılabilir, kısaltılabilir, çevrilebilir veya bağlı şirketler tarafından tekrar kullanılabilir. Olası resmî alan adı kayda daha güçlü bir web kimliği kazandırır ve sonraki zenginleştirme için temel oluşturur.

API yine de aday üretme sistemi olarak ele alınmalıdır. Son eşleşme kararından çağrıyı yapan uygulama sorumludur.

API isteği nasıl gönderilmelidir?

names JSON dizisinde 1–25 benzersiz şirket adı gönderin. Yetkilendirme başlığı gerekmez:

curl 'https://tools-api.growthmarketing.ai/v1/company-search' \
  -H 'Content-Type: application/json' \
  --data '{"names":["Örnek Şirket"]}'

Başarılı yanıt girdi satırını, eşleşme durumunu ve adayları birlikte döndürür:

{
  "success": true,
  "data": {
    "rows": [
      {
        "query": "Örnek Şirket",
        "status": "matched",
        "candidates": [
          {
            "name": "Örnek Şirket",
            "domain": "ornek.com",
            "logoUrl": "https://tools-api.growthmarketing.ai/v1/logo/ornek.com"
          }
        ]
      }
    ]
  }
}

Her satır için ayrı çağrı yapmak yerine adları gruplayın. Hizmet HTTP 429 döndürürse sık aralıkla yeniden denemek yerine Retry-After süresini bekleyin.

Birden çok şirket eşleşmesi nasıl çözülmelidir?

Kaynak kayıtta bulunan kanıtı kullanın:

Kanıtlar çelişiyorsa kaydı çözümlenmemiş bırakın. Dizinin ilk öğesini almak, temiz görünen ancak gizli kimlik hataları taşıyan bir veri kümesi üretir.

Entegrasyon hangi hata durumlarını yönetmelidir?

İstek zaman aşımı belirleyin; doğrulama, hız sınırı, sağlayıcı, sunucu ve ağ yanıtlarını ayrı yönetin. Kısa süreli hataları üst sınır ve gecikmeyle yeniden deneyin. Hatalı girdiyi döngü içinde tekrarlamayın.

Boş dizi başarısız istekle aynı değildir. Hizmet sorgu için aday döndürmemiştir. Bu ayrımı loglarda ve kullanıcı mesajlarında koruyun.

Eşleşen domain ve logo nasıl saklanmalıdır?

Gönderilen adı, eşleşen adı, domaini, logo URL’sini, inceleme durumunu ve tarihini saklayın. Tekrarlanan istekleri azaltmak için kabul edilen eşleşmeleri çalışma akışında önbelleğe alın; şirketler marka ve alan adı değiştirebildiği için sonradan yenilemeye izin verin.

Bir kişinin çok sayıda adı görsel olarak incelemesi gerektiğinde toplu şirket logo bulucuyu kullanın. Şirket zenginleştirme API rehberi, aynı kimlik alanlarını daha geniş veri içe aktarma akışında ele alır.