İlk API isteğinizi gönderin

İlk olarak GET /v1/account isteğini gönderin. Bu salt okunur istek, API anahtarının çalıştığını doğrular ve hangi MailGraf hesabına bağlı olduğunu gösterir. Fatura bilgilerini, kullanıcıları veya diğer hesap ayarlarını açığa çıkarmaz.

Başlamadan önce

Ayarlar > API sayfasında bir API anahtarı oluşturun ve gösterildiği anda kopyalayın. Authorization başlığını henüz hazırlamadıysanız Kimlik doğrulama yazısını okuyun.

Bağlantıyı kontrol edin

1. Terminali açın

   Güvendiğiniz bir bilgisayarda terminali açın. Canlı anahtar içeren isteği ortak kullanılan bir tarayıcı konsolunda veya herkese açık kod ortamında çalıştırmayın.

2. Hesap isteğini gönderin

   mg_live_... değerini kendi anahtarınızla değiştirin ve aşağıdaki komutu çalıştırın.

curl https://api.mailgraf.com/v1/account \
  -H "Authorization: Bearer mg_live_..."

1. Yanıtı okuyun

   Başarılı istek, hesabın kimliği ve adıyla birlikte HTTP 200 yanıtı döndürür.

{
  "id": 42,
  "name": "Northstar Studio"
}

Yanıttaki değerler anahtarın bağlı olduğu hesaptan gelir. Bu nedenle sizin yanıtınız farklı olacaktır.

Hatalı isteği düzeltin

• 401 Unauthorized: başlığın Bearer ile başladığını ve anahtarın iptal edilmediğini kontrol edin.
• 403 Forbidden: hesabın mevcut planı API erişimini içermiyordur.
• 429 Too Many Requests: yeniden denemeden önce Retry-After yanıt başlığında belirtilen saniye kadar bekleyin.

401 veya 403 yanıtını tekrar tekrar göndermeyin. Önce anahtarı ya da hesabın erişim durumunu düzeltin.

Tam referans nerede

Güncel yanıt şeması ve belgelenen tüm hatalar için API referansındaki GET /v1/account bölümünü inceleyin.