# Make ile GenderAPI V2 entegrasyonu

> Shopify kayıtlarını Make HTTP akışıyla GenderAPI V2’ye bağlayın. JSON isteğini, sonuç alanlarını, kredileri ve hata yollarını adım adım eşleyin.

Canonical HTML: https://www.genderapi.io/tr/blog/make-gender-api-integration

Last reviewed: 2026-09-27

## Make bağlantısının API sürümünü ayırın

Bu HTTP rehberi https://api.genderapi.io/api/v2/gender adresini kullanır. JSON gövdesinde type ve value gönderilir; tahmin data, istek ve ücret bilgisi meta içindedir.

Make’in GenderAPI.io uygulamasında isim ve e-posta eylemleri listelenir. Kamuya açık kayıt, tam uç nokta sürümünü veya yanıt şemasını göstermediği için mevcut modülün çıktısını inceleyin. Aşağıdaki HTTP kurulumu doğrudan V2 kullanır; mevcut senaryoyu kendiliğinden yükseltmez.

- [Make GenderAPI.io uygulama kaydı](https://www.make.com/en/integrations/gender-api)
- [Mevcut V1 başvuru belgesi](https://www.genderapi.io/tr/api-documentation/v1)

## Hesabı ve kaynak kaydı hazırlayın

Kaynak ve hedef uygulamalara erişim, GenderAPI hesap anahtarı ve HTTP adımının gerektirdiği platform özellikleri gerekir. Rehber çalışan anahtar veya bağlı hesap sağlamaz. Kaynak kaydın kimliğini koruyun; boş e-posta değerlerini sorgudan önce filtreleyin.

V1 ve V2 aynı hesap anahtarını ve bakiyeyi kullanır. Ücretli sorgudan önce GET /api/v2/usage ile anahtarı doğrulayın; yanıtta meta.access.mode değerinin api_key olduğunu kontrol edin. Eksik veya tanınmayan anahtar ortak IP denemesine düşebilir; üretim otomasyonu fark edilmeden bununla çalışmamalıdır.

Kurulum sırasında akışı kapalı tutun. Test tahmini de normal kredi kullanır. Bu yönergeler kamuya açık belgeler ve V2 sözleşmesi üzerinden incelendi; bağlı hesapta uçtan uca çalıştırılmadı.

- [Kimlik doğrulama ve ücretsiz kullanım kontrolü](https://www.genderapi.io/tr/docs/v2/authentication#environment-setup)

## Make üzerinde V2 HTTP isteğini kurun

- Shopify müşteri tetikleyicisini seçin; müşteri kimliğini saklayın ve boş e-postaları filtreleyin.
- HTTP > Make a request ekleyin. API key kimlik doğrulamasında anahtar değerini Bearer YOUR_API_KEY, yerleşimi Header, parametre adını Authorization ayarlayın; anahtarı URL’ye koymayın.
- POST ve application/json seçin. Data structure ile type ve value metin alanlarını, içinde ai_mode metin alanı olan options koleksiyonunu oluşturun. type: email, ai_mode: off; müşteri e-postası value alanına eşlenir.
- Parse response seçeneğini etkinleştirin. Yapılandırılmış gövde, değerlerin JSON kaçışlarını yönetir; elle metin birleştirmeyin.

| HTTP ayarı | Değer | Amaç |
| --- | --- | --- |
| `Method` | `POST` | Tek tahmin isteği gönderir. |
| `URL` | `https://api.genderapi.io/api/v2/gender` | V2 tekli tahmin uç noktası. |
| `Authorization` | `Bearer YOUR_API_KEY` | Gerçek anahtarı platformun kimlik doğrulama/başlık alanından ekleyin. |
| `Content-Type` | `application/json` | İç içe options nesnesi içeren JSON gönderin; form alanı değil. |
| `options.ai_mode` | `off` | Bilinçli olarak yalnız veri kümesi; unknown dahil 1 kredi. |

## Göndermeden önce JSON gövdesini kontrol edin

Bu, tahmin sonucu değil sabit bir girdi örneğidir. İstek yapısını kontrol ettikten sonra value yerine kaynak alanı JSON kurallarına uygun biçimde eşleyin. Platform eşleme ifadelerini API’ye düz metin olarak göndermeyin.

Başka girdi için type değerini name, email veya username seçip karşılık gelen value alanını gönderin. country isteğe bağlıdır; yalnız ilgili bilgi varsa ekleyin. Bu alan kişinin ikamet ettiği ülkeyi bulmaz.

**Make için V2 JSON isteği**

```json
{
  "type": "email",
  "value": "alex@example.com",
  "options": {
    "ai_mode": "off"
  }
}
```

- [İstek alanları, türler ve varsayılanlar](https://www.genderapi.io/tr/docs/v2/request-parameters)

## Güncellemeyi açmadan HTTP adımını inceleyin

Sabit HTTPS API hedefi için yönlendirmeleri kapalı tutun. HTTP uygulaması sürümünü değiştirirken kimlik doğrulama ve gövde ayarlarını tekrar inceleyin.

Bir kontrollü testin ayrıştırılmış çıktı paketini inceleyin. Müşteri güncellemesinden önce identified, unknown ve hata sonuçlarına ayrı yollar oluşturun.

- [Make başvuru belgesi: gender-api](https://www.make.com/en/integrations/gender-api)
- [Make başvuru belgesi: http](https://apps.make.com/http)
- [Make başvuru belgesi: api-key-authentication-type](https://apps.make.com/api-key-authentication-type)
- [Make başvuru belgesi: automatic-retry-of-incomplete-executions](https://help.make.com/automatic-retry-of-incomplete-executions)

## Bulunan, bilinmeyen ve hatalı sonuçları ayırın

Hedef kaydı güncellemeden önce yanıt gövdesini ayrıştırın. Aşağıdaki yollar V2 gövdesine aittir; platform gövdeyi başka bir alanın içine koyabilir veya alan adlarını düzleştirebilir. Dönen yapıyı kontrollü testte inceleyin ve sonucu kaynak kaydın kimliğiyle saklayın.

Tahmin kişinin kimliğini veya kendi beyanını doğrulamaz. Çıkarımı kişinin verdiği bilgiden ayrı tutun. Kabul eşiğini kendi verinizle değerlendirin; veri kümesi ve AI puanlarını aynı ölçüm gibi kullanmayın.

| Kontrol | Beklenen değer veya tür | Akış kararı |
| --- | --- | --- |
| `meta.access.mode` | api_key | ip_trial ise durup anahtarı düzeltin. Başarılı deneme yanıtı hesap doğrulaması değildir; deneme kredisi tüketilmiş olabilir. |
| `meta.usage.billing_status` | confirmed veya unconfirmed | unconfirmed ise request_id saklanır; devam etmeden veya tekrar göndermeden ücret durumu netleştirilir. |
| `data.result_status / data.gender` | identified ile male/female; unknown ile null | Kabul edilen tahmini ayrı bir çıkarım alanına yazın; unknown için varsayılan kategori atamayın. |
| `data.confidence / data.confidence_kind` | 0–1 veya null; kanıt türü veya null | observed_frequency ile model_reported ayrı yorumlanır; ikisi de genel doğruluk garantisi değildir. |
| `data.source / data.sample_count` | dataset, ai, none / tam sayı veya null | Kaynağı koruyun. AI’nin kayıtlı örnek sayısı yoktur; veri kümesi sayısı ürün doğruluk puanı değildir. |
| `meta.request_id / meta.usage` | İstek referansı / kullanım nesnesi | İş kaydıyla birlikte saklayın; anahtarı ve gereksiz kişisel girdiyi rutin günlüklere yazmayın. |
| `HTTP hatası / eksik yanıt` | Problem Details veya tam yanıt yok | Güncellemeyi durdurup hata ve ücret durumunu inceleyin. Zaman aşımı sunucunun işlem yapmadığını kanıtlamaz. |

- [V2 yanıt alanları](https://www.genderapi.io/tr/docs/v2/responses)
- [Hatalar ve yeniden deneme](https://www.genderapi.io/tr/docs/v2/errors-and-retries)

## Yalnız doğru Shopify kaydını güncelleyin

HTTP modülü gövdeyi bir çıktı etiketinin altına yerleştirebilir. İncelenen paketteki data ve meta alanlarını seçin; yalnız tetikleyiciden saklanan Shopify müşteri kimliğini, ayrı bir çıkarım alanı veya etiket politikasıyla güncelleyin.

Güncellemeyi açmadan bulunan, bilinmeyen ve hatalı sonuç dallarını test edin. Yapay yanıtlarla koşulları yeni tahmin çağrısı yapmadan sınayabilirsiniz. Güncelleme bu kontrollere bağlı olmalı; ilgisiz alan veya etiketleri ezmemelidir.

- [Yanıt alanları](https://www.genderapi.io/tr/docs/v2/responses)

## Tekrarları ve yeniden ücretlendirmeyi kontrol edin

Make hata işleyicilerini ve tamamlanmamış yürütme ayarlarını inceleyin. Açık Retry işleyicisi olmasa bile bazı geçici hatalar tekrar denenebilir. HTTP modülünü tekrarlamak yeniden ücretli sorgu gönderir. Tahmin başarılı olup sonraki Shopify güncellemesi bozulduysa saklanan yanıtı kullanın.

Her yeni GenderAPI isteği bağımsız işlemdir. Kaynak kimliği ve işlem durumuyla yinelenen olayları göndermeden önce kendi akışınızda ayıklayın. Kaynak kayıt kimliği, sunucuda tekrar ücretlendirmeyi engelleyen bir anahtar değildir.

Başarılı unknown tamamlanmış ücretli sonuçtur. Zaman aşımı veya eksik yanıtta sonuç ve ücret belirsiz olabilir; varsa istek referansını koruyup yeniden göndermeden durumu netleştirin. Hız sınırı yanıtında varsa Retry-After değerine uyun.

- [Krediler ve ücret durumu](https://www.genderapi.io/tr/docs/v2/credits-and-usage)

## Yapay zekânın ne zaman kullanılacağını seçin

forceToGenderize; isim, e-posta ve kullanıcı adı girdilerinde isteğe bağlıdır. Açıkken ai_mode alanını göndermeyin veya fallback kullanın. off ve always ile birlikte kullanılması 422 hatası verir. İsteğe başlamak için pozitif bakiye yeterlidir; son ücret bakiyeyi sıfırın altına düşürebilir.

Rumuz analizinde name: null iken cinsiyet tahmini dönebilir. Sonuç unknown da olabilir. Standart yedekleme veya rumuz analizi, doğru ya da dolu bir sonuç garantisi vermez.

| İstek seçeneği | Davranış | Tamamlanan sorgunun maliyeti |
| --- | --- | --- |
| options.ai_mode: off | Yalnızca veri kümesini sorgular. | unknown dahil 1 kredi |
| options.ai_mode: fallback | Önce veri kümesini, cinsiyet tahmini bulunamazsa standart yapay zekâyı kullanır. Tekli sorguların varsayılanıdır. | Yapay zekâ yedeklemesi dahil toplam 1 kredi |
| options.ai_mode: always | Doğrudan yapay zekâya sorar. | 2 kredi |
| forceToGenderize: true | Önce veri kümesine bakar; tahmin bulunamazsa gerçek ön ad içermeyen kişisel rumuzların anlamını da yapay zekâyla yorumlayabilir. | Veri kümesinde tahmin bulunursa 1, yapay zekâ kullanılırsa toplam 2 kredi |

- [Yapay zekâ modları ve rumuz analizi](https://www.genderapi.io/tr/docs/v2/ai-options)
- [Krediler ve kullanım](https://www.genderapi.io/tr/docs/v2/credits-and-usage)

## Hacmi artırmadan önce akışı doğrulayın

- Bir bilinçli testle gerçek JSON gövdesini, ayrıştırılmış alan yollarını, hesap erişimini ve ücret teyidini kontrol edin. Unknown ve hata dallarını mümkünse yapay yanıtlarla test edin.
- Hangi adımların tekrarlandığını ve hangi müşteri alanlarının değiştiğini doğrulayın. Kaynak kimliği, tamamlanan yanıt ve istek referansını saklayın; sonradan hedef güncellemesi bozulursa yeniden tahmin gerekmemeli.
- Küçük ve kontrollü çalıştırmayla başlayın; kayıtları ve kredileri incelemeden eşzamanlılığı artırmayın. GenderAPI kredileri ile otomasyon platformunun görev/işlem ücretleri ayrıdır.
- Toplu sorgu için POST /api/v2/gender/batch kullanılır: hesap anahtarında en fazla 50, IP denemesinde 10 öğe. items içinde isim, e-posta ve kullanıcı adı karışabilir; her öğeye açık seçenekler ve benzersiz kimlik verin. HTTP 200 kısmi hata içerebilir; her öğeyi inceleyin. Hazır bağlayıcının toplu desteği ayrıca doğrulanmalıdır.

- [Toplu sorgu ve kısmi hatalar](https://www.genderapi.io/tr/docs/v2/batch)
- [Python rehberi](https://www.genderapi.io/tr/integrations/python)
- [Node.js rehberi](https://www.genderapi.io/tr/integrations/javascript)

## Make’te API anahtarını URL’ye yazmalı mıyım?

Hayır. HTTP API key kimlik bilgisinde Bearer YOUR_API_KEY değerini Header yerleşimi ve Authorization parametre adıyla saklayın. V2 POST uç noktası key sorgu parametresini kabul etmez.

## Doğrudan HTTP örneğinde AI kullanılabilir mi?

İlk istek options.ai_mode: off kullanır. Standart AI yedeklemesi için fallback toplam 1 kredi, doğrudan AI için always 2 kredidir. forceToGenderize önce veri kümesine bakar; orada sonuç bulunursa 1, AI kullanılırsa toplam 2 kredi olur.

## Bilinmeyen sonuç ücretsiz mi; otomatik tekrarlanabilir mi?

Hayır. Başarılı unknown ücretli ve tamamlanmış sonuçtur. Tekrar yeni işlemdir. Bağlantı hatası veya teyit edilmemiş ücret durumunda yeniden göndermeden usage ve istek referansını inceleyin.

## Bu akış bağlı bir hesapta çalıştırıldı mı?

Hayır. Kurulum kamuya açık platform belgeleri ve V2 sözleşmesiyle incelendi. Üretim güncellemelerini açmadan kendi hesabınızda seçilen eylemin alanlarını, kimlik doğrulamayı, gövdeyi, yanıtı ve tekrar davranışını test edin.

## Başvuru belgeleri

- [Make resmî belgesi: Make GenderAPI.io app listing](https://www.make.com/en/integrations/gender-api)
- [Make resmî belgesi: Make HTTP app configuration](https://apps.make.com/http)
- [Make resmî belgesi: Make API-key credentials and header placement](https://apps.make.com/api-key-authentication-type)
- [Make resmî belgesi: Make automatic retries](https://help.make.com/automatic-retry-of-incomplete-executions)
- [GenderAPI V2 başvuru belgesi](https://www.genderapi.io/tr/docs/v2/request-parameters)
- [GenderAPI V2 başvuru belgesi](https://www.genderapi.io/tr/docs/v2/responses)
- [GenderAPI V2 başvuru belgesi](https://www.genderapi.io/tr/docs/v2/credits-and-usage)