PHPackages                             netgsm/iys - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. netgsm/iys

ActivePackage[Utility & Helpers](/categories/utility)

netgsm/iys
==========

NETGSM ILETI YONETIM SISTEMI

v2.0.1(3y ago)0262↓50%MITPHPPHP >=7.2.5

Since Feb 6Pushed 3y ago1 watchersCompare

[ Source](https://github.com/netgsm/netiys)[ Packagist](https://packagist.org/packages/netgsm/iys)[ RSS](/packages/netgsm-iys/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

İYS (İLETİ YÖNETİM SİSTEMİ)
===========================

[](#i̇ys-i̇leti̇-yöneti̇m-si̇stemi̇)

İleti Yönetim Sistemi (İYS), tüm hizmet sağlayıcıların güncel ticari elektronik ileti onaylarını kaydettikleri ulusal veri tabanı sistemidir. Alıcılar (vatandaşlar) onay verebildikleri gibi, mevcut onayları için ret haklarını da İYS üzerinde kullanabilirler.

Ticari Elektronik İleti; Firmaların, mal ve hizmetlerini pazarlamak, işletmesini tanıtmak ya da kutlama ve temenni gibi içeriklerle tanınırlığını artırmak amacıyla tüketicilere kampanya, özel gün kutlaması,indirim, hediye içerikli vb. gönderdiği mesajlardır.

Ticari elektronik iletinizin içeriği alıcıdan alınan onaya uygun olmalıdır.

 **NETGSM, İleti Yönetim Sistemi Aracı Hizmet Sağlayıcı kurumdur.**

İçindekiler
-----------

[](#i̇çindekiler)

- [İletişim & Destek](#destek)
- [Doküman](#dok%C3%BCman)
- [Supported](#Supported-Laravel-Versions)
- [Kurulum](#kurulum)
- [İys Adres Ekle](#iys-adres-ekleme)
- [İys Adres Sorgula](#iys-adres-sorgulama)
- [İys Webhook](#iys-webhook)

İletişim & Destek
=====================

[](#i̇letişim--destek)

Netgsm API Servisi ile alakalı tüm sorularınızı ve önerilerinizi  adresine iletebilirsiniz.

Doküman
=======

[](#doküman)

API Servisi için hazırlanmış kapsamlı dokümana ve farklı yazılım dillerinde örnek amaçlı hazırlanmış örnek kodlamalara  adresinden ulaşabilirsiniz.

### Supported Laravel Versions

[](#supported-laravel-versions)

Laravel 6.x, Laravel 7.x, Laravel 8.x, Laravel 9.x,

### Supported Lumen Versions

[](#supported-lumen-versions)

Lumen 6.x, Lumen 7.x, Lumen 8.x, Lumen 9.x,

### Supported Symfony Versions

[](#supported-symfony-versions)

Symfony 4.x, Symfony 5.x, Symfony 6.x

### Supported Php Versions

[](#supported-php-versions)

PHP 7.2.5 ve üzeri

### Kurulum

[](#kurulum)

composer require netgsm/iys

.env dosyası içerisinde NETGSM ABONELİK bilgileriniz tanımlanması zorunludur.

**NETGSM\_USERCODE=""**
**NETGSM\_PASSWORD=""**
**NETGSM\_BRANDCODE=""**

PARAMETRELER
------------

[](#parametreler)

 Parametre Anlamı   **type**  letişim adres türü ARAMA, MESAJ ya da EPOSTA dan biri olmalıdırl. Zorunlu parametre     **source**  izin alınan kaynağı ifade eder, HS\_FIZIKSEL\_ORTAM, HS\_ISLAK\_IMZA, HS\_WEB, HS\_CAGRI\_MERKEZI, HS\_SOSYAL\_MEDYA, HS\_EPOSTA, HS\_MESAJ, HS\_MOBIL, HS\_EORTAM, HS\_ETKINLIK, HS\_2015, HS\_ATM ve HS\_KARAR değerlerini alabilir. Zorunlu parametre     **recipient**  İzin alınan kullanıcının telefon numarası ya da e-posta bilgisidir. +905XXXXXXXXX ya da info@netgsm.com.tr formatlarında olmalıdır. Zorunlu parametre     **status**   ONAY ya da RET değerini gönderebilirsiniz. Zorunlu parametre     **consentDate**    İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında gönderilmelidir. Zorunlu parametre     **recipientType**    BIREYSEL ya da TACIR parametre olarak gönderilmelidir. Zorunlu parametre  ### iYS ADRES EKLEME

[](#iys-adres-ekleme)

İYS API Servisi ile Hizmet sağlayıcıların Netgsm İYS İş ortağı aracılığıyla iletişim adreslerini yükleyebilirler.

```
	use Netgsm\Iys\iys;
    	$data=array('type'=>'MESAJ','source'=>'HS_WEB','recipient'=>'+90553xxxxxxx','recipientType'=>'BIREYSEL','status'=>'ONAY','consentDate'=>'2020-11-06 09:40:00');
        $islem=new iys;
        $sonuc=$islem->iys($data);
        dd($sonuc);
        die;
```

#### Başarılı istek örnek sonuç

[](#başarılı-istek-örnek-sonuç)

```
Array
(
    [code] => 0
    [error] => false
    [uid] => 59a3ec87-bca0-xxxx-xxxx-xxxxxxx
)
```

#### Başarısız istek örnek sonuç

[](#başarısız-istek-örnek-sonuç)

```
Array
(
    [code] => 70
    [error] => Hatalı JSON formatı.
    [erroritem] => Array
        (
            [0] => stdClass Object
                (
                    [recipient] =>  +90553xxxxxxx
                )

        )
```

### iYS ADRES SORGULAMA

[](#iys-adres-sorgulama)

Hizmet sağlayıcıların İYS veritabanında kayıtlı iletişim adreslerini sorgulayabileceği servistir.

```
        use  Netgsm\Iys\iys;
    	$data=array('type'=>'MESAJ','recipient'=>'+90553xxxxxxx','recipientType'=>'BIREYSEL');
        $adressorgu=new iys;
        $sonuc=$adressorgu->iysadressorgula($data);

        dd($sonuc);
        die;
       
       
```

#### Başarılı istek örnek sonuç

[](#başarılı-istek-örnek-sonuç-1)

```
Array
(
    [code] => 0
    [error] => false
    [query] => stdClass Object
        (
            [recipientType] => BIREYSEL
            [recipient] => +9055xxxxxxx
            [source] => HS_WEB
            [type] => MESAJ
            [consentDate] => 2023-01-24 09:40:00
            [status] => ONAY
            [creationDate] => 2023-01-26 09:48:54
            [retailerAccessCount] => 0
            [transactionId] => 52402b9a59206462axxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
        )

)
```

#### Başarısız istek örnek sonuç

[](#başarısız-istek-örnek-sonuç-1)

```
Array
(
    [code] => 50
    [error] => Kayıt Bulunamadı.
)
```

### İys Webhook

[](#i̇ys-webhook)

- İYS'ye yüklenen izin ve ret bilgilerinin sonuç durumları, Webhook (Web kancası) uygulaması kullanılarak alınabilir. Bildirim işlemi webhook olarak tanımlanan URL adresine yapılır.
- Bu servisi kullanabilmek için URL'inizi tanımlamanız gerekmektedir. Bu işlem [www.netgsm.com.tr](https://www.netgsm.com.tr/) adresine giriş sağladıktan sonra Dijital Servisler altındaki Netiys modülünden ayarlanabilir, NetİYS Modülü Uygulamalar bölümüne erişmek için, Netgsm web portala login olduktan sonra [tıklayabilirsiniz](https://portal.netgsm.com.tr/webportal/servisler/netiys/webhook)
- İYS izninin veya izin değişikliğinin hangi yolla yapıldığı fark etmeksizin webhook ile URL'e bildirilir.

Urle bildirilen alanlar ParametreAnlamı`iyscode`İYS'de kayıtlı numaranız`brandcode`İYS'de kayıtlı marka kodunuz`type`İletişim adres türü **ARAMA**, **MESAJ** ya da **EPOSTA** dan biri döner.`source`izin alınan kaynağı ifade eder, **HS\_FIZIKSEL\_ORTAM, HS\_ISLAK\_IMZA, HS\_WEB, HS\_CAGRI\_MERKEZI, HS\_SOSYAL\_MEDYA, HS\_EPOSTA, HS\_MESAJ, HS\_MOBIL, HS\_EORTAM, HS\_ETKINLIK, HS\_2015, HS\_ATM ve HS\_KARAR** ya da  **IYS\_3338, IYS\_CM, IYS\_WEB, IYS\_MOBIL, IYS\_KISA\_LINK**  değerlerinden biri döner.`status`**ONAY ya da RET** değeri döner.`consentDate`İzin alınan tarih bilgisi YYYY-mm-dd HH:mm:ss formatında döner.`recipientType`**BIREYSEL ya da TACIR** olarak döner.`retailercode`İzin alınmasında aracılık eden bayinin iyscode bilgisidir.Nümerik bayi iyscode değeri döner.`retailerAccess`İzne erişimi olan bayilerin iyscode bilgisidir. {123456,789456} formatında bayi iyscode bilgisi döner.`submitid`İzin yüklenirken oluşturulan, izin paketine ait id bilgisidir. "40e6215d-b5c6-4896-987c-f30f3678f608" formatında id verisi döner.`recipient`İzin alınan kişinin telefon numarası ya da e-posta adresi bilgisdir. Telefon numaraları E164 uluslararası(\[+\]\[country code\]\[area code\]\[local phone number\]) formatında döner.`resultstatus`İznin işlenme durum bilgisidir. success iznin eklendiğini, failure iznin eklendiğini gösterir.`errcode`İzin işlenirken karşılaşılan hata kodu bilgisdir. "H155" formatında İYS hata kodu formatındadır.`errmsg`İzin işlenirken karşılaşılan hata mesajı bilgisdir. Metin formatında hata mesajı döner.`creationdate`İznin İYS tarafında işleme alındığı tarih bilgisidir. YYYY-MM-DD HH:mm:ss formatında tarih verisi döner.```
{
    "iyscode": 123456,
    "brandcode": 123456,
    "type": "MESAJ",
    "source": "HS_ETKINLIK",
    "status": "ONAY",
    "consentdate": "2010-02-10 13:55:00",
    "recipienttype": "TACIR",
    "retailercode": "987654",
    "retaileraccess": "",
    "submitid": "40e6215d-b5c6-4896-987c-f30f3678f608",
    "recipient": "+90312xxxxxxx",
    "resultstatus": "failure",
    "errcode": "H155",
    "errmsg": "İzin tarihi (consentDate) kabul edilemedi.",
    "creationdate": ""
}
```

##### Laravel kullanıyorsanız veriyi aşağıdaki gibi çekebilirsiniz

[](#laravel-kullanıyorsanız-veriyi-aşağıdaki-gibi-çekebilirsiniz)

```
    use Illuminate\Http\Request;
    public function index(Request $request)
    {

        $data = json_decode($request->getContent(),false);
        $data->recipienttype;
        $data->retailercode;
    }
```

##### Symfony kullanıyorsanız veriyi aşağıdaki gibi çekebilirsiniz

[](#symfony-kullanıyorsanız-veriyi-aşağıdaki-gibi-çekebilirsiniz)

```
    use Symfony\Component\HttpFoundation\Request;
    public function index(Request $request)
    {
       $data = json_decode($request->getContent(),false);
       $data->recipienttype;
       $data->retailercode;

     }
```

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~7 days

Total

2

Last Release

1190d ago

Major Versions

v1.0.1 → v2.0.12023-02-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/db505801dc4dec81bb19c60263a3c406b36d8823feb712e02bbd129085d3a148?d=identicon)[netgsm](/maintainers/netgsm)

---

Top Contributors

[![netgsm1](https://avatars.githubusercontent.com/u/54525685?v=4)](https://github.com/netgsm1 "netgsm1 (23 commits)")[![fatihavci06](https://avatars.githubusercontent.com/u/64631921?v=4)](https://github.com/fatihavci06 "fatihavci06 (3 commits)")

### Embed Badge

![Health badge](/badges/netgsm-iys/health.svg)

```
[![Health](https://phpackages.com/badges/netgsm-iys/health.svg)](https://phpackages.com/packages/netgsm-iys)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)