# Raporlama

* Abone numaranız ile gönderdiğiniz fakslarınızın iletim durumlarını sorgulayabilirsiniz.

```endpoint
POST https://api.netgsm.com.tr/fax/report
```

#### Örnek İstek (Sample Request)
```html
https://api.netgsm.com.tr/fax/report/?usercode=850xxxxxxx&password=xxxxxxxx&bulkid=32443&type=0&status=0
```

#### Örnek Başarılı Cevap (Success Response)
```html
53545	05xxxxxxxxx	0	1
```

#### Örnek Hata Cevabı (Error Response)
```html
HataKodu
```

** Tanımlar **

| Değişken | Zorunlu | Anlamı |
| -------- | ------- | ------ |
| `usercode` | Evet | Netgsm'den hizmet alınan abone numarası (Format: 850xxxxxxx, 312XXXXXXX vs.). |
| `password` | Evet | Alt kullanıcı şifresi. (Alt kullanıcı türü "API Kullanıcısı" olan alt kullanıcıya ait şifre.) |
| `bulkid` | Evet/Opsiyonel | API ile başarılı faks mesaj gönderimlerinizde dönen bulkid'nizdir. |
| `type` | Evet | 0: tek bulkid'ye göre sorgulama yapar, 1: birden çok bulkid'ye göre (Örnek bulkid formatı: 123456,123457,123458) sorgu yapar, 2: tarih aralığına göre sorgu yapar (bulkid parametresindeki değer geçersiz olur.).
| `bastar` | Evet/Opsiyonel | İki tarih arası sorgulamanızda başlangıç tarihi. (Format: ddMMyyyy) |
| `bittar` | Evet/Opsiyonel | İki tarih arası sorgulamanızda bitiş tarihi. (Format: ddMMyyyy)|
| `status` | Opsiyonel | Faksınızın durumunu sorgulamak için kullanılır. * Varsayılan olarak tüm durumları getirir. |

** Servisten Alınan Örnek Cevap **

| Kodu | Anlamı |
| ---- | ------ |
| `53545` | Mesaj ID |
| `312XXXXXXX` | Telefon |
| `0` | Faks Durumu |
| `1` | Gönderim Süresi |

** Faks Durumları **

| Kodu | Anlamı |
| ---- | ------ |
| `1` |	Gönderimi Başarılı |
| `2` |	Cevaplanmayan |
| `3` |	Gönderiliyor |
| `4` |	Gönderilmeyi Bekleyen |
| `7` |	Başlatılamadı |
| `9` |	Hedef numara faks çağrısını açmış ancak faks gönderilememiş |
| `100` | Tüm ileti durumları |

** Hata Durumları **

| Hata Kodu | Anlamı |
| --------- | ------ |
| `30` | Geçersiz kullanıcı adı, şifre veya kullanıcınızın API erişim izninin olmadığını gösterir. Ayrıca eğer API erişiminizde IP sınırlaması yaptıysanız ve sınırladığınız ip dışında gönderim sağlıyorsanız 30 hata kodunu alırsınız. API erişim izninizi veya IP sınırlamanızı, web arayüzümüzden; sağ üst köşede bulunan Abonelik İşlemleri / API işlemleri menüsunden kontrol edebilirsiniz. |
| `60` | Arama kriterlerinize göre listelenecek kayıt olmadığını ifade eder. |
| `70` | Hatalı sorgulama. Gönderdiğiniz parametrelerden birisi hatalı veya zorunlu alanlardan birinin eksik olduğunu ifade eder. |