Genel Bakış

Versiyon bilgisi

Versiyon : 1.0.0

URI şeması

Sunucu : gunici-prp.epias.com.tr
Kök Dizin : /gunici-service
Şemalar : HTTPS

Etiketler

  • announcement

  • announcement-exist

  • authorization

  • configs

  • contract

  • dashboard

  • dashboard-configs

  • limit

  • lookup-detail

  • match-detail

  • menu

  • objection

  • offer

  • offer-exist

  • operation-history

  • organization-info

  • participation-exist

  • user-info

Sürüm Değişiklik Notları

11.01.2024

2.0.1

  • Kullanıcı doğrulama yöntemlerine JWT ile servis çağırımı eklendi.

    • TGT ve ST ile servis çağırımlarını aynı zamanda JWT ile de yapabilirsiniz. JWT ile her seferinde CAS sisteminden TGT veya ST almadan tek bir JWT ile servisleri çağırabilirsiniz.

  • Sistem genelinde performans iyileştirmeleri yapıldı.

15.02.2024

2.0.2

  • Teklif eşik değerlerine kalan limitlerin milisaniye cinsinden kalan zaman bilgisi eklendi.

Doküman Hakkında

Bu dokümanda güniçi servislerinin tanımları ve bu servislerin nasıl çağrılacağı anlatılmaktadır. Güniçi servis dökümanları iki kısımdan oluşmaktadır. Şuan baktığınız doküman 2.kısımdır. Birinci kısma erişmek için buraya tıklayınız.

1. GÜNİÇİ Servisleri Hakkında

Güniçi uygulaması REST servisler üzerine kuruludur. JSON ve XML isteklerini kabul eder ve gelen isteğe göre JSON yada XML cevap döner.

Uygulamanın kullanıcı arayüzünde görmüş olduğunuz bilgilerin tamamı dışarıya açık olan bu servislerden alınmaktadır. Bu arayüzü kullanmadan da sahip olduğunuz uygulamalar ile sistemi kullanmanız mümkündür.

Uygulamayı çağırabilmek için EKYS de kayıtlı bir kullanıcınız olmalı ve bu kullanıcının ilgili servisleri çağırabilmek için yeterli yetkisi olmalıdır. Uygulamaya gelen tüm istekler Merkezi Yetkilendirme Sunucusu’ndan (cas.epias.com.tr) TGT, ST veya JWT alınarak bir tanesi gönderilmelidir.

2. İstemci Oluşturmak

Servis dokümantasyonu Swagger ile hazırlanmıştır. Test ortamı için buraya tıklayınız. Gerçek ortam için buradaki dosyasını kullanarak https://editor-next.swagger.io/ adresinden kullandığınız dile uygun istemci kodlarını oluşturabilirsiniz.

3. GÜNİÇİ Uygulaması Servis Çağrımı

3.1. Kullanıcı doğrulaması

TGT (Ticket Granting Ticket) ve JWT (JSON Web Token) kullanıcının oturumunu kontrol eder. TGT Servisinden alacağınız değer 45 dakika boyunca kullanmasanız bile aktiftir. Eğer hiç bir kullanım olmaz ise 45 dakika sonra aldığınız TGT geçersiz hale gelir. TGT değerini her kullanışınızda 45 dakikalık süre tekrar başlar ve maksimum en fazla 8 saat kullanılabilir sonrasında aynı TGT tekrar kullanamazsınız.

JWT ise oluşturulduğu tarihten itibaren kullanıcının ayarlamış olduğu oturum süresi kadar geçerliliği vardır.

TGT ve JWT tekrar kullanılabilen bir değerdir. Her istek için TGT veya JWT almanıza gerek yoktur. Her istek için TGT almanız halinde CAS (Merkezi Yetkilendirme Sunucusu) tarafından bloke edilebilirsiniz.

Test ve canlı ortamlar için kullanılacak CAS adresleri aşağıdadır.

Test ve canlı ortamlar için kullanılacak günici servislerinin adresleri aşağıdadır.

3.1.1. TGT ve Service Ticket Oluşturma

TGT Oluşturma
POST /cas/v1/tickets?format=text HTTP/1.1
Host: testcas.epias.com.tr
Content-Type: application/x-www-form-urlencoded
Content-Length: 34

username=KULLANICI_AD&password=SIFRE
Cevap
TGT-22405-E7CgL3qrP3SmTjZlHXRdaPU7ww3AQKY7MspE0y1mpeTaMelbtL-prp-cashazel-n201
Service Ticket Oluşturma
POST /cas/v1/tickets/TGT-22405-E7CgL3qrP3SmTjZlHXRdaPU7ww3AQKY7MspE0y1mpeTaMelbtL-prp-cashazel-n201 HTTP/1.1
Host: testcas.epias.com.tr
Content-Type: application/x-www-form-urlencoded
Content-Length: 38

service=https://gunici-prp.epias.com.tr
Cevap
ST-267789-5tclFz9ONNy3MtqbICe5-prp-cashazel-n201

3.1.2. JWT Oluşturma

JWT oluşturabilmeniz için adresindeki servisi üzerinden kullanıcı bilgi servisi çağırılır. Bu servisin cevabında yer alan accessToken bilgisi ile her bir servis çağırımı sırasında headerda intraday-jwt değeri gönderilmelidir.

Örnek Kullanıcı Bilgi İsteği
GET /gunici-service/rest/v1/user/info HTTP/1.1
Host: gunici-prp.epias.com.tr
Accept: application/json
TGT: TGT-4248-SfR4IrEYwTgsAeVqxuElOGAZRt91nx6gMBvPGTM9jOZffKURAkCJC6-ourgVgBmO3KM-cas-78cbcbb758-fszpn
Örnek Kullanıcı Bilgi İsteği
{
  "status": "200 OK",
  "txId": "4a6f8c91-bdd7-4c41-89cf-aba7638b82b6",
  "hostName": null,
  "clientIp": "0:0:0:0:0:0:0:1",
  "userName": "EXIST",
  "errors": null,
  "body": {
    "content": {
      "user": {
        "userId": 1,
        "userName": "EXIST",
        "name": "EXIST",
        "lastName": "EXIST",
        "organization": {
          "id": 1,
          "etsoCode": "40X000000000001P",
          "name": "EXIST A.Ş.",
          "shortName": "EXIST",
          "isActive": true,
          "type": "MARKET_PARTICIPANT",
          "subType": "PRODUCTION"
        },
        "userType": {
          "key": "PK",
          "value": "PK"
        },
        "phone": "909999999999",
        "email": "exist@epias.com.tr",
        "locale": "TR",
        "adminLimits": {
          "minSellPrice": 0,
          "maxSellQuantity": 1000,
          "maxBuyPrice": 1000.0000000000,
          "maxBuyQuantity": 10000,
          "isCheckMcp": false,
          "deviationAmount": null,
          "deviationType": null,
          "maxTotalBuy": null,
          "maxTotalSell": null,
          "netStatusBuy": null,
          "netStatusSell": null,
          "isCheckedPreventOffer": null,
          "region": null
        },
        "userLimits": {
          "minSellPrice": 0,
          "maxSellQuantity": 1000,
          "maxBuyPrice": 1000.0000000000,
          "maxBuyQuantity": 1000,
          "isCheckMcp": false,
          "deviationAmount": null,
          "deviationType": null,
          "maxTotalBuy": null,
          "maxTotalSell": null,
          "netStatusBuy": null,
          "netStatusSell": null,
          "isCheckedPreventOffer": false,
          "region": null
        },
        "sessionTime": 45,
        "organizationLimits": {
          "TR1": {
            "region": "TR1",
            "maxTotalBuy": 20000,
            "maxTotalSell": 20000,
            "netStatusBuy": 100000,
            "netStatusSell": 100000,
            "maxBuyQuantity": 20000,
            "maxSellQuantity": 20000,
            "maxBuyPrice": 10000,
            "minSellPrice": 0,
            "isCheckMcp": false,
            "deviationAmount": null,
            "deviationType": null
          }
        },
        "existUser": false
      },
      "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
      "webSocketDto": {
        "url": "/socket/all/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c",
        "parameters": [
          {
            "key": "jwt",
            "value": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          }
        ],
        "channels": [
          {
            "channelName": "HourlyContractBoard",
            "url": "/socket/hourly-contract-board/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "BlockContractBoard",
            "url": "/socket/block-contract-board/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "TradeHistoryChannel",
            "url": "/socket/trade-history-channel/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OfferHistoryChannel",
            "url": "/socket/offer-history-channel/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "NetPositionChannel",
            "url": "/socket/net-position-channel/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OrganizationLimitStatus",
            "url": "/socket/organization-limit-status-channel/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "ContractMessage",
            "url": "/socket/contract-message/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "HourlyContractClosedMessage",
            "url": "/socket/hourly-contract-closed-message/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "BlockContractClosedMessage",
            "url": "/socket/block-contract-closed-message/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OpenTradeDay",
            "url": "/socket/open-trade-day/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "AjaxEventChannel",
            "url": "/socket/ajax-event-channel/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "Announcement",
            "url": "/socket/announcement/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "Notification",
            "url": "/socket/notification/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "MatchingDetail",
            "url": "/socket/matching-detail/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "Ping",
            "url": "/socket/ping/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OrderDepth",
            "url": "/socket/order-depth/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OrganizationBestOffer",
            "url": "/socket/organization-best-offer/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OrderDepthChart",
            "url": "/socket/order-depth-chart/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          },
          {
            "channelName": "OrganizationSync",
            "url": "/socket/organization-sync/12394cf3572fd123qaw0c9753ae6fe456?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
          }
        ]
      },
      "authorizations": {
        "intraday.intraday": {
          "roles": [
            "read",
            "write",
            "master"
          ]
        }
      }
    }
  }
}
Örnek JWT İsteği
POST /gunici-service/rest/v1/offer/list HTTP/1.1
Host: gunici-prp.epias.com.tr
Content-Type: application/json
Accept: application/json
intraday-jwt: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
Content-Length: 383

{
"contractTypes": [],
"effectiveDateStart": "2023-12-31 00:00:00",
"effectiveDateEnd": "2024-01-02 00:00:00",
"region": "TR1",
"offerId": null,
"contractNames": [],
"offerType": null,
"offerStatuses": [],
"offerOptionTypes": [],
"offerDetailStatuses": [],
"username": null,
"pageInfo": {
"page": 1,
"size": 100
}
}

Güniçi servislerinin standart bir mesaj yapısı bulunmaktadır. Gönderdiğiniz tüm isteklerde bu formata uygun veri göndermelisiniz.

Öncelikle her isteğin HTTP header alanına aşağıdaki değerleri eklemelisiniz.

parametre değer

Accept

application/json veya application/xml

Content-Type

application/json veya application/xml

CLIENT_CORRELATION_ID

Kullanıcı tarafından her bir istek için oluşturulan tekil numara (Bu bilginin tekilliği tamamen kullanıcının kontrolündedir)

Kimlik doğrulaması yapabilmemiz için aşağıdaki parametrelerden birini servisin header kısmında göndermeniz gerekmektedir.

parametre değer

intraday-service-ticket

(Service Ticket) Örnek : ST-1411741-uZ0RcYx1PQRWwtf3fDzO-qa-cashazel-n201

TGT

(TGT) Örnek : TGT-22405-E7CgL3qrP3SmTjZlHXRdaPU7ww3AQKY7MspE0y1mpeTaMelbtL-prp-cashazel-n201

intraday-jwt

(JWT) Örnek : eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c

Kimlik doğrulaması için bu bilgilerden herhangi birini göndermemeniz durumunda kimlik bilgilerini doğrulanamadığı için HTTP 400 hata kodu dönecektir. Eğer bu alanlardan hiç birini yollamazsanız HTTP 301 hatası alacaksınızdır.

Geçerliliği bitmiş bir TGT veya JWT ile işlem yapmanız durumunda aşağıdaki gibi bir hata alacaksınız.

Örnek JSON Mesajı
{
  "status": "301 MOVED_PERMANENTLY",
  "txId": "b835bd86-ba2f-4d76-9fa6-6014c27b5b2b",
  "hostName": "10.233.104.19",
  "clientIp": "10.199.199.59",
  "userName": null,
  "errors": [
    {
      "errorCode": "AUT001",
      "errorMessage": "Kimlik bilgileriniz Doğrulanamamıştır."
    }
  ],
  "body": {},
  "dispatch": "https://cas-qa.epias.com.tr/cas/logout"
}

Eğer geçersiz bir TGT ST veya JWT göndermeniz durumunda aşağıdaki şekilde hata mesajı alacaksınız.

Örnek JSON Mesajı
{
  "status": "401 UNAUTHORIZED",
  "txId": "dc98eca6-9648-4647-843f-66ac5eab44c1",
  "hostName": "10.0.0.1",
  "clientIp": "10.0.0.1",
  "userName": null,
  "errors": [
    {
      "errorCode": "AUT001",
      "errorMessage": "Kimlik bilgileriniz doğrulanamamıştır."
    }
  ],
  "body": {}
}

3.2. Güniçi Uygulaması Örnek Mesaj Yapısı

Her bir servise has parametreleri içeren body alanını göndermeniz gerekmektedir. Tüm servisler için farklılık gösterebilir.

Aşağıda örnek mesaj bulunmaktadır.

Örnek JSON Mesajı
{
  "startDate": "2021-01-01 00:00:00",
  "endDate": "2021-02-01 00:00:00"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "fc34b9d1-e2db-4c25-bbde-430cb381aba5",
  "hostName": "10.199.199.69",
  "clientIp": "127.0.0.1",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "objections": [
      {
        "id": 1,
        "objectionTime": "2021-01-27 12:38:31",
        "contractName": "PH21012800",
        "region": "TR1",
        "organization": "EPIAŞ",
        "objectionUser": "TESTUSER",
        "status": {
          "key": "ACCEPT",
          "value": "Kabul"
        },
        "description": "hatalı eşleşme",
        "reply": "itirazınız kabul edilmiştir."
      }
    ]
  }
}
Hatalı JSON Cevabı
{
  "status": "400 BAD_REQUEST",
  "txId": "064b23f6-00e9-45bc-bb60-790de9b2004a",
  "hostName": "10.199.199.57",
  "clientIp": "127.0.0.1",
  "userName": "EPIAS",
  "errors": [
    {
      "errorCode": "(VAL)OFFER014",
      "errorMessage": "Güncellemek istediğiniz teklif güncellenebilir durumda değildir."
    },
    {
      "errorCode": "(VAL)CONTRACT002",
      "errorMessage": "PH21062408 isimli kontrat aktif durumda değildir."
    }
  ],
  "body": null
}
Servise gelen ve giden tüm mesajlardaki tarih formatı yyyy-MM-dd HH:mm:ss şeklinde olmalıdır. Örnek bir zaman değeri şu şekildedir. 2021-06-23 22:00:00

Gönderilen tüm isteklere dönen cevaplar da iki bölümden oluşur. Birinci bölüm isteğin başarılı olup olmadığını dönen status değeri. İkinci bölüm ise body alanında sonucu dönen kısım.

Her sonuç mesajında aşağıdaki alanlar sabit olarak bulunur.

parametre tip değer açıklama

status

string

"200 OK" başarılı diğer hallerde hatakodu içerir

Aldığınız hatanın HTTP status kodunu dönmektedir.

error

list

Başarılı durumda liste boş dönmektedir

Hata almanız durumunda liste içinde aldığınız hatanın hata kodu ve hata mesajlarını dönmektedir. Hatalar ile ilgili detaylı bilgi almak isterseniz bu değerleri göndermeniz gerekmektedir.

txId

string

Yapmış olduğunuz isteği tekilleştirmeye yarar

hata almanız durumunda bu bilgiyi göndermeniz zorunludur.

clientIp

string

İsteği yapan clientin ip bilgisi

userName

string

İsteği yapan kullanıcı bilgisi

body

object

Yapılan istek başarılı olması durumunda çağırılan servisin cevabı . İstekler başarısız ise bu alan boş gelecektir.

3.3. Uygulama tarafından dönülen HTTP durum kodları.

Uygulama tarafından dönüş yapılan HTTP durum kodları aşağıdaki gibidir.

HTTP Durum Kodu Açıklama

200

İşlemin başarılı olduğunu gösterir

301

Kimlik doğrulaması yapılması için gerekli olan header bilgilerini göndermediğiniz durumlarda dönmektedir.

400

İş kurallarından dolayı oluşan hatalar için dönmektedir.

401

İşlemi yapmaya yetkiniz olmadığında dönmektedir.

429

Teklif eşik değeri aşılması durumunda dönmektedir.

500

Sistemde beklenmedik hatalar oluştuğunda dönmektedir.

3.4. Uygulama tarafından dönülen hata mesajları listesi

Uygulama tarafından verilen hata mesajları aşağıdaki gibidir..

Hata Kodları ve Mesajları
Uygulama Hata Kodu Hata Mesajı Örnek Hata Mesajı

gunici-trading-service

CORE001

Sistemde beklenmedik bir hata oluştu.Lütfen hata kodu ve transaction id ile birlikte EPİAŞ bildiriniz.

gunici-trading-service

CORE002

Sistemde beklenmedik bir hata oluştu.Lütfen hata kodu ve transaction id ile birlikte EPİAŞ bildiriniz.

gunici-trading-service

CORE003

Çağırdığınız adres bilgisi hatalıdır. Lütfen yapmış olduğunuz isteği kontrol ediniz.

gunici-trading-service

AUT001

Kimlik bilgileriniz doğrulanamamıştır.

gunici-trading-service

AUT002

{0} isminde bir kullanıcı bilgisi EKYS sistemlerinde bulunamamıştır. Lütfen EPİAŞ ile irtibata geçiniz.

gunici-trading-service

AUT003

{0} kullanıcısı için EKYS tarafından yetkilerini alınamamıştır.Lütfen EPİAŞ ile irtibata geçiniz.

gunici-trading-service

AUT004

Kullanıcının uygulama limitlerini bulunamamıştır.

gunici-trading-service

AUT005

JWT geçerlilik süresi dolmuştur.Lütfen yeni bir token alıp tekrar deneyiniz.

gunici-trading-service

AUT006

Kullanıcı bilgileriniz doğulanamamıştır.

gunici-trading-service

AUT007

Bu işlemi yapmaya yetkiniz bulunmamaktadır.

gunici-trading-service

AUT008

Organizasyonunuzun durumu aktif değildir.Lütfen EPİAŞ ile irtibata geçiniz.

gunici-trading-service

OFFER001

Teklif fiyatı boş olamaz.

gunici-trading-service

OFFER003

Teklif miktarı boş olamaz.

gunici-trading-service

OFFER004

Teklif miktarı minimum {0} olabilir.

Teklif miktarı minimum 1 olabilir.

gunici-trading-service

OFFER005

Teklifin kontrat bilgisi boş olamaz.

gunici-trading-service

OFFER006

Teklifin alış satış bilgisi boş olamaz.

gunici-trading-service

OFFER007

Teklif durum bilgisi boş olamaz.

gunici-trading-service

OFFER008

Güncelleme yapabilmeniz için teklif numarasını boş bırakamazsınız.

gunici-trading-service

OFFER009

Teklif durumu sadece aktif,pasif veya iptal olabilir.

gunici-trading-service

OFFER010

Bölge bilgisini boş bırakamazsınız.

gunici-trading-service

OFFER011

Teklif opsiyon bilgisini boş bırakamazsınız.

gunici-trading-service

OFFER013

{0} numaralı teklif bulunamamıştır.

gunici-trading-service

OFFER014

Güncellemek istediğiniz teklif güncellenebilir durumda değildir.

gunici-trading-service

OFFER015

Teklif açıklaması en fazla 1024 karakter olabilir.

gunici-trading-service

OFFER016

{0} teslim günü için {1} firmasının katılım anlaşması bulunmamaktadır.

gunici-trading-service

OFFER017

Özel emir teklifi girişi yapabilmeniz için karşıdaki organizasyon bilgisi boş olamaz.

gunici-trading-service

OFFER023

Zaman seviyeli teklifin aktif olma zamanı boş olamaz.

gunici-trading-service

OFFER024

Zaman seviyeli teklifler arasında en az {0} dakika fark olması gerekmektedir.

gunici-trading-service

OFFER025

Zaman seviyeli teklifin aktif olma zamanı kontrat kapanmasından önce en az {0} dakika kadar fark olması gerekmektedir.

gunici-trading-service

OFFER026

Zaman seviyeli teklifin fiyatları artan şekilde olmalıdır.

gunici-trading-service

OFFER027

Zaman seviyeli teklifin fiyatları azalan şekilde olmalıdır.

gunici-trading-service

OFFER028

Zaman seviyeli teklif en fazla {0} adet seviyesi olmalıdır.

gunici-trading-service

OFFER029

{0} numaralı zaman seviyeli teklif olduğundan dolayı teklif güncellemesine izin verilmemektedir.Sadece iptal edilebilir.

gunici-trading-service

OFFER030

Zaman seviyeli teklifin durumu sadece iptal edilebilir.

gunici-trading-service

OFFER031

Zaman seviyeli teklif girebilmeniz için en az bir seviye olması gerekmektedir.

gunici-trading-service

OFFER032

Fiyat seviyeli teklif girebilmeniz için en az bir seviye olması gerekmektedir.

gunici-trading-service

OFFER033

Fiyat seviyeli teklif seviyelerinin fiyatları artacak şekilde olmalıdır.

gunici-trading-service

OFFER034

Fiyat seviyeli teklif seviyelerinin fiyatları azalacak şekilde olmalıdır.

gunici-trading-service

OFFER035

Fiyat seviyeli teklif girebilmeniz için en fazla {0} adet seviye girebilirsiniz.

gunici-trading-service

OFFER036

Fiyat seviyeli teklif girebilmeniz için seviye bilgisini boş bırakamazsınız.

gunici-trading-service

OFFER037

{0} numaralı teklif fiyat seviyeli teklif olduğundan dolayı teklif güncellemesine izin verilmemektedir.Sadece iptal edilebilir.

gunici-trading-service

OFFER038

{0} numaralı teklif fiyat seviyeli teklif olduğundan dolayı teklif sadece iptal edilebilir.

gunici-trading-service

OFFER039

{0} bölge bilgisi bulunamamıştır.

gunici-trading-service

OFFER040

Blok teklif girişi için seçilebilecek teklif opsiyonları Normal ve TEYE’dir.

gunici-trading-service

OFFER041

Seçilebilecek minimum blok süresi {0} saatdir.

gunici-trading-service

OFFER042

Pasif teklif girebilmeniz için teklif opsiyonunu normal seçmeniz gerekmektedir.

gunici-trading-service

OFFER043

Süreli teklif girebilmeniz için teklif opsiyonunu normal seçmeniz gerekmektedir.

gunici-trading-service

OFFER044

Geçerlilik zaman bilgisi {0} ile {1} tarihleri arasında olabilir.

gunici-trading-service

OFFER046

Fiyat seviyeli teklif seviyeleri {0}'den başlamalıdır.

gunici-trading-service

OFFER047

Fiyat seviyeli teklif seviyeleri arasında boşluk olmamalıdır.

gunici-trading-service

OFFER048

Güncellemek istediğiniz teklifin son versiyonu değişmiştir. Teklifinizin son versiyonunu kontrol ediniz.

gunici-trading-service

OFFER049

Teklifinizin durum bilgisini mevcut durum ile aynı yollayamazsınız.

gunici-trading-service

OFFER050

Zaman seviyeli teklif seviyeleri arasında boşluk olmamalıdır.

gunici-trading-service

OFFER051

{0} bölgesinde {1} kontratında güncellenebilir bir teklifiniz bulunmamaktadır.

gunici-trading-service

OFFER052

{0} bölgesine ait {1} kontrattaki TEO değeriniz {2}’e ulaşmıştır. İlgili kontrattaki TEO değeriniz {2}’ün altına düşmediği sürece ilgili kontrat için herhangi bir işlem gerçekleştiremezsiniz.

gunici-trading-service

OFFER053

{0} bölgesinde {1} kontratına birden fazla teklif girişi yapamazsınız.

gunici-trading-service

OFFER054

Toplu teklif girişi için seçilebilecek teklif opsiyonları Normal,TEYE veya OEYE’dir.

gunici-trading-service

OFFER055

"{0}" sebebiyle/sebepleriyle teklifiniz teklif kaydetme sırasına girmeyecektir.

gunici-trading-service

OFFER056

Kaydedilecek teklif listesi boş olamaz.

gunici-trading-service

OFFER057

Client order id bilgisi en fazla {0} karakter olabilir.

gunici-trading-service

OFFER058

Buzdağı seviye miktarı bilgisi boş olamaz.

gunici-trading-service

OFFER059

Buzdağı seviye miktarı ile teklif miktarı aynı olamaz.

gunici-trading-service

OFFER060

Buzdağı seviye miktarı {0} ile {1} lotları arasında olabilir.

gunici-trading-service

OFFER061

Buzdağı teklif için teklif miktarı en fazla {0} lot olabilir.

gunici-trading-service

OFFER062

Buzdağı teklifler haricinde seviye miktarı boş olmalıdır.

gunici-trading-service

OFFER063

Buzdağı tekliflerde teklif miktarı seviye miktarından büyük olmak zorundadır.

gunici-trading-service

OFFER064

{0} teslim günü için blok teklif girişleri kapalıdır.

gunici-trading-service

OFFER065

Teklif girişlerine sistem kapalı durumdadır.

gunici-trading-service

OFFER066

Vermiş olduğunuz teklif EPİAŞ tarafıından belirlenen Minimum Teklif Fiyat Adımı parametresine uygun değildir.

gunici-trading-service

CONTRACT001

{0} bölgesinde {1} isimli kontrat bulunamamıştır. Bölge ve kontrat bilgilerini kontrol ediniz.

gunici-trading-service

CONTRACT002

{0} isimli kontrat aktif durumda değildir.

gunici-trading-service

CONTRACT003

Kontratları listeleyebilmeniz için kontrat tipini seçmeniz gerekmektedir.

gunici-trading-service

CONTRACT004

Girmiş olduğunuz teklif ismi uygun formatte değildir.Girilen kontrat ismi : {0}

gunici-trading-service

CONTRACT005

Kontrat durumunu boş bırakamazsınız.

gunici-trading-service

CONTRACT006

Kontrat ismi boş olamaz.

gunici-trading-service

CONTRACT007

Bölge ismi boş olamaz.

gunici-trading-service

CONTRACT008

Kontrat kapanma zamanı boş olamaz.

gunici-trading-service

CONTRACT009

Kontrat kapanma zamanı en erken {0} saat olabilir.

gunici-trading-service

CONTRACT010

Kontrat tipi ve türü uyumsuz.

gunici-trading-service

CONTRACT011

Blok teklifin kapsadığı saat aralığı birden fazla günü kapsayamaz.

gunici-trading-service

CONTRACT012

Blok teklifin teslim başlangıç tarihi bitiş tarihinden küçük olmak zorundadır.

gunici-trading-service

CONTRACT013

Başlangıç zamanı uygun aralıkta değil, [00,23] aralığında olmalı.

gunici-trading-service

CONTRACT014

Bitiş zamanı uygun aralıkta değil, [01,24] aralığında olmalı.

gunici-trading-service

CONTRACT015

Teslimat zamanı girildiğinden başlangıç zamanı da girilmeli.

gunici-trading-service

CONTRACT016

Başlangıç zamanı blok kontratın ilk teslim saatinden önce olamaz.

gunici-trading-service

CONTRACT017

Bitiş zamanı blok kontratın son teslim saatinden sonra olamaz.

gunici-trading-service

CONTRACT018

Teslim tarihi geçerli aralıkta değil.

gunici-trading-service

CONTRACT019

Teslim tarihinde geçerli bir parametre değeri bulunmamaktadır.

gunici-trading-service

CONTRACT020

Bitiş zamanı, başlangıç zamanından büyük olmalıdır.

gunici-trading-service

CONTRACT021

Bitiş zamanı ile başlangıç zamanı farkı minimum teklif süresinden az olamaz.

gunici-trading-service

CONTRACT022

Teslim tarihi boş iken başlangıç veya bitiş zamanı alanları girilemez.

gunici-trading-service

CONTRACT023

Başlangıç saati geçerli değil.

gunici-trading-service

CONTRACT024

Bitiş saati geçerli değil.

gunici-trading-service

CONTRACT025

Blok teklif minimum teklif süresi parametresi bulunamadı.

gunici-trading-service

CONTRACT026

Teslim tarihi ve bitiş zamanı dolu iken başlangıç zamanı boş olamaz.

gunici-trading-service

CONTRACT027

Kontrat listesi boş olamaz.

gunici-trading-service

CONTRACT028

Güncellenmek istenilen {0} bölgesindeki {1} kontratın durumu ile güncellenmek istenilen durum aynıdır.

gunici-trading-service

CONTRACT029

Kontratın durumu zaman aşımı olarak güncellenemez.

gunici-trading-service

CONTRACT030

{0} bölgesindeki {1} kontratın durumunun güncellenmesi sırasında hata almıştır.

gunici-trading-service

CONTRACT031

Kontrat kapalı olduğu için işlem yapılamaz.

gunici-trading-service

CONTRACT032

Kaydetmeye çalışılan blok teklifin kapsadığı zaman aralığında üretilmeyecek kontrat değeri olduğundan teklifiniz kaydedilmemiştir.

gunici-trading-service

LIMIT001

Kullanıcı limitlerinizin dışında bir teklif miktarı giremezsiniz.

gunici-trading-service

LIMIT002

Girmiş olduğunuz teklif fiyatının PTF’ye oranı %{0} üstünde olamaz.

gunici-trading-service

LIMIT003

Girmiş olduğunuz teklif fiyatının PTF’ye oranı %{0} altında olamaz.

gunici-trading-service

LIMIT004

Yönetici limitlerinizin dışında bir teklif miktarı giremezsiniz.

gunici-trading-service

LIMIT005

Teklif girebilmeniz için kullanıcı limitlerinizi tanımlamanız gerekmektedir.

gunici-trading-service

LIMIT006

Girmiş olduğunuz teklifin fiyat veya miktarı uygulama limitlerini aşmaktadır.

gunici-trading-service

LIMIT007

Teklif girebilmeniz için kullanıcı üst limitlerinizi tanımlamanız gerekmektedir.

gunici-trading-service

LIMIT008

Kullanıcı limitleriniz dışında bir teklif girişi yapmak için limit aşımına onay vermeniz gerekmektedir. Limit aşımı hata detayı : {0}

gunici-trading-service

LIMIT009

Alış yönünde teklif limitlerine takıldınız.

gunici-trading-service

LIMIT010

Satış yönünde teklif limitlerine takıldınız.

gunici-trading-service

LIMIT011

Satış yönünde organizasyon limitlerine takıldınız.

gunici-trading-service

LIMIT012

Alış yönünde organizasyon limitlerine takıldınız.

gunici-trading-service

LIMIT013

{0} teklif bölgesi için organizasyon limitleriniz bulunmamaktadır.

gunici-trading-service

LIMIT014

Organizasyon limitlerinizin dışında bir teklif miktarı giremezsiniz.

gunici-trading-service

LIMIT015

Satış yönünde organizasyon net durum limitlerine takıldınız.

gunici-trading-service

LIMIT016

Alış yönünde organizasyon net durum limitlerine takıldınız.

gunici-trading-service

LIMIT017

Girmiş olduğunuz teklifin fiyatı PTF’nin {0} TL/MWh üstünde olamaz.

gunici-trading-service

LIMIT018

Girmiş olduğunuz teklifin fiyatı PTF’nin {0} TL/MWh altında olamaz.

gunici-trading-service

COL001

Sistemde geçerli bir teminat bilgisi bulunamamıştır. Lütfen EPİAŞ ile irtibata geçiniz.

gunici-trading-service

COL002

Teminat yetersizliği sebebi ile teklif veremezsiniz.

gunici-service

CORE001

Sistemde beklenmedik bir hata oluştu.Lütfen hata kodu ve transaction id ile birlikte EPİAŞ bildiriniz.

gunici-service

CORE002

Sistemde beklenmedik bir hata oluştu.Lütfen hata kodu ve transaction id ile birlikte EPİAŞ bildiriniz.

gunici-service

CORE003

Çağırdığınız adres bilgisi hatalıdır. Lütfen yapmış olduğunuz isteği kontrol ediniz.

gunici-service

AUT001

Kimlik bilgileriniz doğrulanamamıştır.

gunici-service

AUT002

{0} isminde bir kullanıcı bilgisi EKYS sistemlerinde bulunamamıştır. Lütfen EPİAŞ ile irtibata geçiniz.

gunici-service

AUT003

{0} kullanıcısı için EKYS tarafından yetkilerini alınamamıştır.Lütfen EPİAŞ ile irtibata geçiniz.

gunici-service

AUT004

Kullanıcının uygulama limitlerini bulunamamıştır.

gunici-service

AUT005

JWT geçerlilik süresi dolmuştur.Lütfen yeni bir token alıp tekrar deneyiniz.

gunici-service

AUT006

Kullanıcı bilgileriniz doğulanamamıştır.

gunici-service

AUT007

Bu işlemi yapmaya yetkiniz bulunmamaktadır.

gunici-service

AUT008

Organizasyonunuzun durumu aktif değildir.Lütfen EPİAŞ ile irtibata geçiniz.

gunici-service

LIMIT004

Yöneticiniz tarafıdan limitleriniz belirlenmemiştir.

gunici-service

LIMIT005

Yöneticinin belirlemiş olduğu minimum satış fiyatının altında limit tanımlayamazsınız.

gunici-service

LIMIT006

Yöneticinin belirlemiş olduğu maksimum satış miktarı üstünde limit tanımlayamazsınız.

gunici-service

LIMIT007

Yöneticinin belirlemiş olduğu maksimum alış fiyatı üstünde limit tanımlayamazsınız.

gunici-service

LIMIT008

Yöneticinin belirlemiş olduğu maksimum alış miktarı üstünde limit tanımlayamazsınız.

gunici-service

OBJECTION001

İtiraz yapabilmeniz için lütfen açıklama bilgisini doldurunuz.

gunici-service

OBJECTION002

İtiraz açıklaması en fazla 1024 karakter olabilir.

gunici-service

OBJECTION003

İtirazlar sadece bir eşleşme için yapılabilir.Lütfen bir eşleşme seçiniz.

gunici-service

OBJECTION004

Seçtiğiniz eşleşme bilgisi bulunamamıştır.

gunici-service

OBJECTION005

İtiraz için ayrılan zamanı geçmiştir. Bu eşleşme için herhangi bir itirazda bulunamazsınız.

gunici-service

OBJECTION006

Seçilen eşleşme için zaten bir itiraz bulunmaktadır.

gunici-service

OBJECTION007

Lütfen geçerli bir itiraz seçiniz.

gunici-service

OBJECTION008

Seçmiş olduğunuz itiraz bilgisi bulunamamıştır.

gunici-service

USERLIMIT001

Maksimum toplam alış alanı boş olamaz.

gunici-service

USERLIMIT002

Maksimum toplam satış alanı boş olamaz.

gunici-service

USERLIMIT003

Net durum alış alanı boş olamaz.

gunici-service

USERLIMIT004

Net durum satış alanı boş olamaz.

gunici-service

USERLIMIT005

Maksimum alış teklif miktarı alanı boş olamaz.

gunici-service

USERLIMIT006

Maksimum satış teklif miktarı alanı boş olamaz.

gunici-service

USERLIMIT007

Maksimum alış teklif fiyatı alanı boş olamaz.

gunici-service

USERLIMIT008

Minimum satış teklif fiyatı alanı boş olamaz.

gunici-service

USERLIMIT009

PTF’ye göre teklif kontrolü yap alanı boş olamaz.

gunici-service

USERLIMIT010

PTF’ye göre teklif kontrolü yap alanı seçiliyken PTF’ye göre sapma alanı boş olamaz.

gunici-service

USERLIMIT011

Tüm kullanıcılara uygula alanı boş olamaz.

gunici-service

USERLIMIT012

Güncellenmek istenen kullanıcı bilgisi hatalı.

gunici-service

USERLIMIT013

Maksimum toplam alış alanı uygun aralıkta değil.

gunici-service

USERLIMIT014

Maksimum toplam satış alanı uygun aralıkta değil.

gunici-service

USERLIMIT015

Net durum alış alanı uygun aralıkta değil.

gunici-service

USERLIMIT016

Net durum satış alanı uygun aralıkta değil.

gunici-service

USERLIMIT017

Maksimum alış teklif miktarı alanı uygun aralıkta değil.

gunici-service

USERLIMIT018

Maksimum satış teklif miktarı alanı uygun aralıkta değil.

gunici-service

USERLIMIT019

Maksimum alış teklif fiyatı alanı uygun aralıkta değil.

gunici-service

USERLIMIT020

Minimum satış teklif fiyatı alanı uygun aralıkta değil.

gunici-service

USERLIMIT021

PTF’ye göre sapma alanı uygun aralıkta değil.

gunici-service

USERLIMIT022

Tüm kullanıcılara uygula alanı seçilmedikçe güncellenecek kullanıcı bilgileri boş olamaz.

gunici-service

USERLIMIT023

Organizasyona ait limit aralık değerleri bulunamadı.

gunici-service

USERLIMIT024

Kullanıcıya ait kullanıcı üst limit bilgisi bulunamadı.

gunici-service

USERLIMIT025

Sorgulanan aktif bir kullanıcı bulunamadı.

gunici-service

USERLIMIT026

Kullanıcı üst limiti kayıt işlemi başarısız.

gunici-service

USERLIMIT027

Limit Aşımında Teklif Kaydını Engelle alanı zorunludur.

gunici-service

USERLIMIT028

PTF’ye göre sapma tutarı minimum 0 TL/MWh olabilir.

gunici-service

USERLIMIT029

Minimum satış fiyatı minimum 0 TL/MWh olabilir.

gunici-service

USERLIMIT030

Maksimum alış fiyatı minimum 0 TL/MWh olabilir.

gunici-service

USERLIMIT031

Maksimum satış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT032

Maksimum alış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT033

Net durum satış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT034

Net durum alış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT035

Maksimum toplam satış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT036

Maksimum toplam alış miktarı minimum 1 Lot olabilir.

gunici-service

USERLIMIT037

Kullanıcı Üst Limitleri bulunamadı.

gunici-service

USERLIMIT038

PTF’ye göre teklif kontrolü yap alanı seçili değilken PTF’ye göre sapma alanı değiştirilemez.

gunici-service

USERLIMIT039

Tarih alanı boş olamaz.

gunici-service

USERLIMIT040

Talep Edilen Maksimum Toplam Alış Miktarı alanı boş olamaz.

gunici-service

USERLIMIT041

Talep Edilen Maksimum Toplam Satış Miktarı alanı boş olamaz.

gunici-service

USERLIMIT042

PK Açıklama alanı boş olamaz.

gunici-service

USERLIMIT043

Organizasyonun mevcut toplam limit miktarları bulunmamakta. Katılım anlaşmanız onaylandıysa EPİAŞ ile irtibata geçiniz.

gunici-service

USERLIMIT044

Organizasyonun bekleme statüsünde olan bir talebi olduğundan yeni bir talep giremezsiniz.

gunici-service

USERLIMIT045

Epiaş Kullanıcısı, organizasyon için limit talep değişikliğinde bulunamaz.

gunici-service

USERLIMIT046

Organizasyon bulunamadı.

gunici-service

USERLIMIT047

Seçilen kullanıcı ismi sistemde bulunmamaktadır.

gunici-service

USERLIMIT048

Seçilen kullanıcı, seçilen organizasyona ait değil.

gunici-service

USERLIMIT049

Seçilen organizasyon bulunmamaktadır.

gunici-service

USERLIMIT050

Organizasyon ve kullanıcı adı seçimi zorunlu.

gunici-service

USERLIMIT051

Organizasyon limit değişiklik talebi id alanı boş olamaz.

gunici-service

USERLIMIT052

Sorgulanan organizasyon limit değişiklik talep id’ye ait kayıt bulunamadı.

gunici-service

USERLIMIT053

Yalnızca kendi organizasyonuza ait açılmış talepleri reddedebilirsiniz.

gunici-service

USERLIMIT054

Yalnızca Beklemede olan talep iptal edilebilir.

gunici-service

USERLIMIT056

Maksimum toplam miktar limitinin üstünde talepte bulunamazsınız.

gunici-service

USERLIMIT057

Maksimum toplam miktar limitinin sistemde mevcut değil, lütfen EPİAŞ ile iletişime geçiniz.

gunici-service

USERLIMIT058

Seçilen organizasyon bilgisi bulunmamaktadır.

gunici-service

USERLIMIT059

Talep Id bilgisi boş olamaz.

gunici-service

USERLIMIT060

Yalnızca Beklemede olan talep onaylanabilir.

gunici-service

USERLIMIT061

Onaylanan Maksimum Toplam Alış Miktarı alanı boş olamaz.

gunici-service

USERLIMIT062

Onaylanan Maksimum Toplam Satış Miktarı alanı boş olamaz.

gunici-service

USERLIMIT063

Limit talep değişikliği için onayınız mevcut.

gunici-service

USERLIMIT064

Yalnızca Beklemede olan talep reddedilebilir.

gunici-service

USERLIMIT065

Birinci onaylayan kullanıcı, talebi reddedemez.

gunici-service

USERLIMIT066

Yalnızca EPİAŞ kullanıcısı bu işlemi yapabilir.

gunici-service

USERLIMIT067

İkinci onaylayan kullanıcı, birinci onaylayan kullanıcının onayladığı değerden farklı bir talepte bulunamaz.

gunici-service

USERLIMIT069

Geçmiş tarihli bir talep için herhangi bir işlem yapamazsınız.

gunici-service

USERLIMIT070

Maksimum toplam alış miktarı boş olamaz.

gunici-service

USERLIMIT071

Maksimum toplam satış miktarı boş olamaz.

gunici-service

USERLIMIT072

Maksimum alış teklif miktarı boş olamaz.

gunici-service

USERLIMIT073

Maksimum satış teklif miktarı boş olamaz.

gunici-service

USERLIMIT074

Maksimum alış teklif fiyatı boş olamaz.

gunici-service

USERLIMIT075

Minimum satış teklif fiyatı boş olamaz.

gunici-service

USERLIMIT076

PTFye göre fiyat sapma miktarı minimum {0} olabilir.

gunici-service

USERLIMIT077

PTFye göre sapma miktarı boş olamaz.

gunici-service

USERLIMIT078

Maksimum toplam alış miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT079

Maksimum toplam satış miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT080

Net durum alış miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT081

Net durum satış miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT082

Maksimum alış teklif miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT083

Maksimum satış teklif miktarı en fazla {0} olabilir.

gunici-service

USERLIMIT084

Maksimum alış teklif teklif fiyatı en fazla {0} olabilir.

gunici-service

USERLIMIT085

Maksimum satış teklif teklif fiyatı en fazla {0} olabilir.

gunici-service

USERLIMIT086

Açıklama alanı en fazla {0} karakter olabilir.

gunici-service

USERLIMIT087

Maksimum toplam alış miktarı minimum {0} olabilir.

gunici-service

USERLIMIT088

Maksimum toplam satış miktarı minimum {0} olabilir.

gunici-service

USERLIMIT089

PTF’ye göre sapma oranı ondalık sayı olamaz.

gunici-service

USERLIMIT090

PTF’ye göre teklif kontrolü yap alanı seçiliyken PTF’ye göre sapma tipi alanı boş olamaz.

gunici-service

USERLIMIT091

PTF’ye göre teklif kontrolü yap alanı seçili değilken PTF’ye göre sapma tipi alanı değiştirilemez.

gunici-service

USERLIMIT092

PTF’ye göre sapma tipi boş olamaz.

gunici-service

CONFIGS001

Bildirim görüntüleme süresi 1 saniyeden az olamaz.

gunici-service

CONFIGS002

Bildirim görüntüleme süresi 10 saniyeden çok olamaz.

gunici-service

CONFIGS003

Kontrat detay bildirimi zorunlu alandır.

gunici-service

CONFIGS004

Minimum eşleşme bildirim miktarı zorunlu alandır.

gunici-service

CONFIGS005

Saatlik toplam eşleşme sınırı zorunlu alandır.

gunici-service

CONFIGS006

Bildirim durumu zorunlu alandır.

gunici-service

CONFIGS007

Bildirim tipi zorunlu alandır.

gunici-service

CONFIGS008

Bildirimin minimum değeri zorunlu alandır.

gunici-service

CONFIGS009

Bildirimin minimum değeri en düşük {0} olabilir.

gunici-service

CONFIGS010

Kontrat detay bildiriminde sadece e-posta gönderimi yapılmaktadır.

gunici-service

CONFIGS011

Bildirimin minimum değeri en yüksek {0} olabilir.

gunici-service

CONFIGS012

Günlük özet bildirimi zorunlu alandır.

4. Servis Detayları

Bu bölümden kategorilerine göre Servis çağırım detayları ile ilgili bilgilere ulaşabilirsiniz.

5. Teklif Listeleme

Teklif listeleme için aşağıdaki gibi bir mesaj yollamanız gerekmektedir. Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "effectiveDateStart": "2022-01-01 10:00:00",
  "effectiveDateEnd": "2022-01-01 14:00:00",
  "contractNames": [],
  "contractStatuses": [],
  "contractTypes": [],
  "offerDetailStatuses": [],
  "offerId": [],
  "offerOptionTypes": [],
  "offerStatuses": [],
  "offerType": null,
  "region": "TR1",
  "username": null,
  "version": null,
  "pageInfo": {
    "page": 1,
    "size": 3
  },
  "sortingInfo": {
    "ascending": true,
    "fieldName": "matchingTime"
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f13624ef-351d-4bdf-b066-8699988f6262",
  "hostName": "10.42.12.41",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 3,
        "count": 5
      },
      "offers": [
        {
          "time": "2022-01-01 11:00:00.404",
          "id": 1,
          "contractName": "PH22010112",
          "contract": {
            "id": 101,
            "name": "PH22010112",
            "deliveryDateStart": "2022-01-01 12:00:00.000",
            "deliveryDateEnd": "2022-01-01 13:00:00.000",
            "duration": 1.00,
            "lastTransactionDate": "2022-01-01 11:00:00.000",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "contractKind": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "status": {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            },
            "region": {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            }
          },
          "offerType": {
            "label": "Alış",
            "value": "BUY",
            "description": "Alış"
          },
          "status": {
            "label": "İptal",
            "value": "CANCEL",
            "description": "İptal"
          },
          "statusDetail": {
            "label": "ZA",
            "value": "ZA",
            "description": "Zaman Aşımı"
          },
          "price": 800.00,
          "quantity": 2000,
          "remainingQuantity": 245,
          "remainingIcebergQuantity": null,
          "levelQuantity": null,
          "matchingPrice": 797.33,
          "matchingQuantity": 1755,
          "description": null,
          "username": "EPIAS",
          "region": "TR1",
          "optionType": {
            "label": "Normal",
            "value": "NORMAL",
            "description": "Normal"
          },
          "version": 13,
          "expireTime": null,
          "updatable": false,
          "clientOrderId": null
        },
        {
          "time": "2022-01-01 10:25:18.831",
          "id": 2,
          "contractName": "PH22010113",
          "contract": {
            "id": 201,
            "name": "PH22010113",
            "deliveryDateStart": "2022-01-01 13:00:00.000",
            "deliveryDateEnd": "2022-01-01 14:00:00.000",
            "duration": 1.00,
            "lastTransactionDate": "2022-01-01 12:00:00.000",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "contractKind": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "status": {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            },
            "region": {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            }
          },
          "offerType": {
            "label": "Alış",
            "value": "BUY",
            "description": "Alış"
          },
          "status": {
            "label": "Eşleşti",
            "value": "MATCHING",
            "description": "Eşleşti"
          },
          "statusDetail": {
            "label": "TE",
            "value": "TE",
            "description": "Tamamı Eşleşti"
          },
          "price": 1056.86,
          "quantity": 2000,
          "remainingQuantity": 0,
          "remainingIcebergQuantity": null,
          "levelQuantity": null,
          "matchingPrice": 1050.26,
          "matchingQuantity": 2000,
          "description": null,
          "username": "EPIAS",
          "region": "TR1",
          "optionType": {
            "label": "Normal",
            "value": "NORMAL",
            "description": "Normal"
          },
          "version": 20,
          "expireTime": null,
          "updatable": false,
          "clientOrderId": null
        },
        {
          "time": "2022-01-01 09:42:27.809",
          "id": 3,
          "contractName": "PH22010112",
          "contract": {
            "id": 101,
            "name": "PH22010112",
            "deliveryDateStart": "2022-01-01 12:00:00.000",
            "deliveryDateEnd": "2022-01-01 13:00:00.000",
            "duration": 1.00,
            "lastTransactionDate": "2022-01-01 11:00:00.000",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "contractKind": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "status": {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            },
            "region": {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            }
          },
          "offerType": {
            "label": "Alış",
            "value": "BUY",
            "description": "Alış"
          },
          "status": {
            "label": "Eşleşti",
            "value": "MATCHING",
            "description": "Eşleşti"
          },
          "statusDetail": {
            "label": "TE",
            "value": "TE",
            "description": "Tamamı Eşleşti"
          },
          "price": 800.00,
          "quantity": 1600,
          "remainingQuantity": 0,
          "remainingIcebergQuantity": null,
          "levelQuantity": null,
          "matchingPrice": 799.23,
          "matchingQuantity": 1600,
          "description": null,
          "username": "EPIAS",
          "region": "TR1",
          "optionType": {
            "label": "Normal",
            "value": "NORMAL",
            "description": "Normal"
          },
          "version": 13,
          "expireTime": null,
          "updatable": false,
          "clientOrderId": null
        }
      ]
    }
  }
}

5.1. Teklif Geçmiş Listeleme

Teklifinize ait hareketlerinizi listeleyen servistir. Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "offerId": 1,
  "pageInfo": {
    "page": 1,
    "size": 5
  },
  "isChartDetail": true
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "fbb5c43b-cd0b-40b4-8eb2-626bd5f3508c",
  "hostName": "10.42.3.103",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 2,
        "count": 13
      },
      "histories": [
        {
          "time": "2022-01-01 11:00:00.335",
          "offerId": 1,
          "contract": {
            "id": 201,
            "name": "PH22010112",
            "deliveryDateStart": "2022-01-01 12:00:00.000",
            "deliveryDateEnd": "2022-01-01 13:00:00.000",
            "duration": 1.00,
            "lastTransactionDate": "2022-01-01 11:00:00.000",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "contractKind": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "status": {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            },
            "region": {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            }
          },
          "offerType": {
            "label": "Alış",
            "value": "BUY",
            "description": "Alış"
          },
          "price": 800.00,
          "quantity": 2000,
          "remainingQuantity": 245,
          "remainingIcebergQuantity": null,
          "levelQuantity": null,
          "status": {
            "label": "İptal",
            "value": "CANCEL",
            "description": "İptal"
          },
          "statusDetail": {
            "label": "ZA",
            "value": "ZA",
            "description": "Zaman Aşımı"
          },
          "matchPrice": 800.00,
          "matchQuantity": 114,
          "matchingDetailId": 1001,
          "matchingStatus": {
            "label": "Geçerli",
            "value": "VALID",
            "description": "Geçerli"
          },
          "version": 13,
          "username": "SYSTEM",
          "optionType": {
            "label": "Normal",
            "value": "NORMAL",
            "description": "Normal"
          },
          "description": null,
          "organizationId": 195
        },
        {
          "time": "2022-01-01 10:31:17.666",
          "offerId": 1,
          "contract": {
            "id": 201,
            "name": "PH22010112",
            "deliveryDateStart": "2022-01-01 12:00:00.000",
            "deliveryDateEnd": "2022-01-01 13:00:00.000",
            "duration": 1.00,
            "lastTransactionDate": "2022-01-01 11:00:00.000",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "contractKind": {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            "status": {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            },
            "region": {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            }
          },
          "offerType": {
            "label": "Alış",
            "value": "BUY",
            "description": "Alış"
          },
          "price": 800.00,
          "quantity": 2000,
          "remainingQuantity": 245,
          "remainingIcebergQuantity": null,
          "levelQuantity": null,
          "status": {
            "label": "Aktif",
            "value": "ACTIVE",
            "description": "Aktif"
          },
          "statusDetail": {
            "label": "KE",
            "value": "KE",
            "description": "Kismi Eşleşme"
          },
          "matchPrice": 800.00,
          "matchQuantity": 114,
          "matchingDetailId": 1001,
          "matchingStatus": {
            "label": "Geçerli",
            "value": "VALID",
            "description": "Geçerli"
          },
          "version": 12,
          "username": "SYSTEM",
          "optionType": {
            "label": "Normal",
            "value": "NORMAL",
            "description": "Normal"
          },
          "description": null,
          "organizationId": 195
        }
      ],
      "timeLeveledOfferDetails": null,
      "priceLeveledOfferDetails": null,
      "charts": [
        {
          "version": 1,
          "remainingQuantity": 2000,
          "matchQuantity": null
        },
        {
          "version": 2,
          "remainingQuantity": 1980,
          "matchQuantity": 20
        },
        {
          "version": 3,
          "remainingQuantity": 1970,
          "matchQuantity": 10
        },
        {
          "version": 4,
          "remainingQuantity": 1945,
          "matchQuantity": 25
        },
        {
          "version": 5,
          "remainingQuantity": 1745,
          "matchQuantity": 200
        },
        {
          "version": 6,
          "remainingQuantity": 1075,
          "matchQuantity": 670
        },
        {
          "version": 7,
          "remainingQuantity": 1066,
          "matchQuantity": 9
        },
        {
          "version": 8,
          "remainingQuantity": 1036,
          "matchQuantity": 30
        },
        {
          "version": 9,
          "remainingQuantity": 836,
          "matchQuantity": 200
        },
        {
          "version": 10,
          "remainingQuantity": 737,
          "matchQuantity": 99
        },
        {
          "version": 11,
          "remainingQuantity": 359,
          "matchQuantity": 378
        },
        {
          "version": 12,
          "remainingQuantity": 245,
          "matchQuantity": 114
        },
        {
          "version": 13,
          "remainingQuantity": null,
          "matchQuantity": 114
        }
      ]
    }
  }
}

5.2. Teklif Listeleme (GraphQL)

Teklifleri listeleme sırasında graphQL servislerini kullanarak gelen tüm alanlar yerine ihtiyacınız olan olanları çekmeniz mümkündür.

Örnek İsteği
POST /gunici-service/graphql HTTP/1.1
Host: https://gunici-prp.epias.com.tr
Content-Type: application/json
Accept: application/json
Content-Length: 865

{"query":"query {
  listOffers(req: {
    region: \"TR1\",
    effectiveDateStart: \"2023-01-01T00:00:00\",
    effectiveDateEnd: \"2023-12-31T23:59:59\",
    contractTypes: [HOURLY, BLOCK],
    contractStatuses: [ACTIVE, PASSIVE],
    offerType: BUY,
    pageInfo: {
      page: 1,
      size: 10
    }
  }) {
    offers {
      id
      time
      contractName
      contract {
        id
        name
        deliveryDateStart
        deliveryDateEnd
        duration
        lastTransactionDate
        contractType {
          label
          value
        }
        status {
          label
          value
        }
      }
      price
      quantity
      remainingQuantity
      description
      username
      region
    }
    queryInformation {
      page
      size
      count
    }
  }
}","variables":{}}
Örnek GraphQL İsteği
query {
  listOffers(req: {
    region: "TR1",
    effectiveDateStart: "2023-01-01T00:00:00",
    effectiveDateEnd: "2023-12-31T23:59:59",
    contractTypes: [HOURLY, BLOCK],
    contractStatuses: [ACTIVE, PASSIVE],
    offerType: BUY,
    pageInfo: {
      page: 1,
      size: 10
    }
  }) {
  offers {
  id
  time
  contractName
  contract {
  id
  name
  deliveryDateStart
  deliveryDateEnd
  duration
  lastTransactionDate
  contractType {
  label
  value
}
status {
  label
  value
}
}
price
quantity
remainingQuantity
description
username
region
}
queryInformation {
page
size
count
}
}
}
Örnek GraphQL Cevabı
{
  "data": {
    "listOffers": {
      "offers": [
        {
          "id": "1",
          "time": "2023-10-26T15:53:30.165069",
          "contractName": "PH23102621",
          "contract": {
            "id": "3088559163",
            "name": "PH23102621",
            "deliveryDateStart": "2023-10-26T21:00",
            "deliveryDateEnd": "2023-10-26T22:00",
            "duration": 1.0,
            "lastTransactionDate": "2023-10-26T20:00",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY"
            },
            "status": {
              "label": "Aktif",
              "value": "ACTIVE"
            }
          },
          "price": 100.0,
          "quantity": 50,
          "remainingQuantity": 0,
          "description": null,
          "username": "PK195",
          "region": "TR1"
        },
        {
          "id": "2",
          "time": "2023-10-26T15:03:29.856951",
          "contractName": "PH23102711",
          "contract": {
            "id": "3088559201",
            "name": "PH23102711",
            "deliveryDateStart": "2023-10-27T11:00",
            "deliveryDateEnd": "2023-10-27T12:00",
            "duration": 1.0,
            "lastTransactionDate": "2023-10-27T10:00",
            "contractType": {
              "label": "Saatlik",
              "value": "HOURLY"
            },
            "status": {
              "label": "Aktif",
              "value": "ACTIVE"
            }
          },
          "price": 5.0,
          "quantity": 50,
          "remainingQuantity": 50,
          "description": null,
          "username": "PK195",
          "region": "TR1"
        }
      ],
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 2
      }
    }
  }
}
Teklif Listeleme GraphQL Schema
{
  "data": {
    "__schema": {
      "queryType": {
        "name": "Query"
      },
      "mutationType": null,
      "subscriptionType": null,
      "types": [
        {
          "kind": "SCALAR",
          "name": "Boolean",
          "description": "Built-in Boolean",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "ContractDto",
          "description": "",
          "fields": [
            {
              "name": "id",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "ID",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "name",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "deliveryDateStart",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "LocalDateTime",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "deliveryDateEnd",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "LocalDateTime",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "duration",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Float",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "lastTransactionDate",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "LocalDateTime",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "contractType",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "contractKind",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "status",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "region",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "ContractStatus",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "ACTIVE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "PASSIVE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "EXPIRE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "ContractType",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "HOURLY",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "BLOCK",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "PRIVATE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "SCALAR",
          "name": "Float",
          "description": "Built-in Float",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "SCALAR",
          "name": "ID",
          "description": "Built-in ID",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "SCALAR",
          "name": "Int",
          "description": "Built-in Int",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "LabelValueDTO",
          "description": "",
          "fields": [
            {
              "name": "label",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "value",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "SCALAR",
          "name": "LocalDateTime",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "INPUT_OBJECT",
          "name": "OfferListReqDto",
          "description": "",
          "fields": null,
          "inputFields": [
            {
              "name": "region",
              "description": "",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "effectiveDateStart",
              "description": "",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "LocalDateTime",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "effectiveDateEnd",
              "description": "",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "LocalDateTime",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "contractTypes",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "ContractType",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "contractStatuses",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "ContractStatus",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "offerId",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "Int",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "contractNames",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "offerType",
              "description": "",
              "type": {
                "kind": "ENUM",
                "name": "OfferType",
                "ofType": null
              },
              "defaultValue": null
            },
            {
              "name": "offerStatuses",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "OfferStatus",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "offerDetailStatuses",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "OfferStatusDetail",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "offerOptionTypes",
              "description": "",
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "OfferOptionType",
                  "ofType": null
                }
              },
              "defaultValue": null
            },
            {
              "name": "username",
              "description": "",
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "defaultValue": null
            },
            {
              "name": "version",
              "description": "",
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "defaultValue": null
            },
            {
              "name": "pageInfo",
              "description": "",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "INPUT_OBJECT",
                  "name": "PageDto",
                  "ofType": null
                }
              },
              "defaultValue": null
            }
          ],
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "OfferListResponseDto",
          "description": "",
          "fields": [
            {
              "name": "offers",
              "description": "",
              "args": [],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "OBJECT",
                  "name": "OfferRespDto",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "queryInformation",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "QueryInformationDto",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "OfferOptionType",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "NORMAL",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "IOC",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "FOK",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "PRICE_LEVELED",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ICEBERG",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "TIME_LEVELED",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "OfferRespDto",
          "description": "",
          "fields": [
            {
              "name": "id",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "ID",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "time",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "LocalDateTime",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "contractName",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "contract",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "ContractDto",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "offerType",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "status",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "statusDetail",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "price",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Float",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "quantity",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "remainingQuantity",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "matchingPrice",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Float",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "matchingQuantity",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "username",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "region",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "optionType",
              "description": "",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "LabelValueDTO",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "version",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "expireTime",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "LocalDateTime",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "clientOrderId",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "OfferStatus",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "ACTIVE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "PASSIVE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "MATCHING",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "CANCEL",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "OfferStatusDetail",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "YE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "GU",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "PA",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "KE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ZA",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "TY",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "KA",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "IP",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "TE",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "IK",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "OfferType",
          "description": "",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "BUY",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "SELL",
              "description": "",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "INPUT_OBJECT",
          "name": "PageDto",
          "description": "",
          "fields": null,
          "inputFields": [
            {
              "name": "page",
              "description": "",
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "defaultValue": null
            },
            {
              "name": "size",
              "description": "",
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "defaultValue": null
            }
          ],
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "Query",
          "description": "",
          "fields": [
            {
              "name": "listOffers",
              "description": "",
              "args": [
                {
                  "name": "req",
                  "description": "",
                  "type": {
                    "kind": "NON_NULL",
                    "name": null,
                    "ofType": {
                      "kind": "INPUT_OBJECT",
                      "name": "OfferListReqDto",
                      "ofType": null
                    }
                  },
                  "defaultValue": null
                }
              ],
              "type": {
                "kind": "OBJECT",
                "name": "OfferListResponseDto",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "QueryInformationDto",
          "description": "",
          "fields": [
            {
              "name": "page",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "size",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "count",
              "description": "",
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Int",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "SCALAR",
          "name": "String",
          "description": "Built-in String",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__Directive",
          "description": null,
          "fields": [
            {
              "name": "name",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "locations",
              "description": null,
              "args": [],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "ENUM",
                    "name": "__DirectiveLocation",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "args",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "LIST",
                  "name": null,
                  "ofType": {
                    "kind": "NON_NULL",
                    "name": null,
                    "ofType": {
                      "kind": "OBJECT",
                      "name": "__InputValue",
                      "ofType": null
                    }
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "onOperation",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Boolean",
                "ofType": null
              },
              "isDeprecated": true,
              "deprecationReason": "Use `locations`."
            },
            {
              "name": "onFragment",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Boolean",
                "ofType": null
              },
              "isDeprecated": true,
              "deprecationReason": "Use `locations`."
            },
            {
              "name": "onField",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "Boolean",
                "ofType": null
              },
              "isDeprecated": true,
              "deprecationReason": "Use `locations`."
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "__DirectiveLocation",
          "description": "An enum describing valid locations where a directive can be placed",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "QUERY",
              "description": "Indicates the directive is valid on queries.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "MUTATION",
              "description": "Indicates the directive is valid on mutations.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "FIELD",
              "description": "Indicates the directive is valid on fields.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "FRAGMENT_DEFINITION",
              "description": "Indicates the directive is valid on fragment definitions.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "FRAGMENT_SPREAD",
              "description": "Indicates the directive is valid on fragment spreads.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INLINE_FRAGMENT",
              "description": "Indicates the directive is valid on inline fragments.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "SCHEMA",
              "description": "Indicates the directive is valid on a schema SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "SCALAR",
              "description": "Indicates the directive is valid on a scalar SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "OBJECT",
              "description": "Indicates the directive is valid on an object SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "FIELD_DEFINITION",
              "description": "Indicates the directive is valid on a field SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ARGUMENT_DEFINITION",
              "description": "Indicates the directive is valid on a field argument SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INTERFACE",
              "description": "Indicates the directive is valid on an interface SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "UNION",
              "description": "Indicates the directive is valid on an union SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ENUM",
              "description": "Indicates the directive is valid on an enum SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ENUM_VALUE",
              "description": "Indicates the directive is valid on an enum value SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INPUT_OBJECT",
              "description": "Indicates the directive is valid on an input object SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INPUT_FIELD_DEFINITION",
              "description": "Indicates the directive is valid on an input object field SDL definition.",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__EnumValue",
          "description": null,
          "fields": [
            {
              "name": "name",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "isDeprecated",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "Boolean",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "deprecationReason",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__Field",
          "description": null,
          "fields": [
            {
              "name": "name",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "args",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "LIST",
                  "name": null,
                  "ofType": {
                    "kind": "NON_NULL",
                    "name": null,
                    "ofType": {
                      "kind": "OBJECT",
                      "name": "__InputValue",
                      "ofType": null
                    }
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "type",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "OBJECT",
                  "name": "__Type",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "isDeprecated",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "Boolean",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "deprecationReason",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__InputValue",
          "description": null,
          "fields": [
            {
              "name": "name",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "type",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "OBJECT",
                  "name": "__Type",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "defaultValue",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__Schema",
          "description": "A GraphQL Introspection defines the capabilities of a GraphQL server. It exposes all available types and directives on the server, the entry points for query, mutation, and subscription operations.",
          "fields": [
            {
              "name": "types",
              "description": "A list of all types supported by this server.",
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "LIST",
                  "name": null,
                  "ofType": {
                    "kind": "NON_NULL",
                    "name": null,
                    "ofType": {
                      "kind": "OBJECT",
                      "name": "__Type",
                      "ofType": null
                    }
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "queryType",
              "description": "The type that query operations will be rooted at.",
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "OBJECT",
                  "name": "__Type",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "mutationType",
              "description": "If this server supports mutation, the type that mutation operations will be rooted at.",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "__Type",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "directives",
              "description": "'A list of all directives supported by this server.",
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "LIST",
                  "name": null,
                  "ofType": {
                    "kind": "NON_NULL",
                    "name": null,
                    "ofType": {
                      "kind": "OBJECT",
                      "name": "__Directive",
                      "ofType": null
                    }
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "subscriptionType",
              "description": "'If this server support subscription, the type that subscription operations will be rooted at.",
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "__Type",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "OBJECT",
          "name": "__Type",
          "description": null,
          "fields": [
            {
              "name": "kind",
              "description": null,
              "args": [],
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "ENUM",
                  "name": "__TypeKind",
                  "ofType": null
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "name",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "description",
              "description": null,
              "args": [],
              "type": {
                "kind": "SCALAR",
                "name": "String",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "fields",
              "description": null,
              "args": [
                {
                  "name": "includeDeprecated",
                  "description": null,
                  "type": {
                    "kind": "SCALAR",
                    "name": "Boolean",
                    "ofType": null
                  },
                  "defaultValue": "false"
                }
              ],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "OBJECT",
                    "name": "__Field",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "interfaces",
              "description": null,
              "args": [],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "OBJECT",
                    "name": "__Type",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "possibleTypes",
              "description": null,
              "args": [],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "OBJECT",
                    "name": "__Type",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "enumValues",
              "description": null,
              "args": [
                {
                  "name": "includeDeprecated",
                  "description": null,
                  "type": {
                    "kind": "SCALAR",
                    "name": "Boolean",
                    "ofType": null
                  },
                  "defaultValue": "false"
                }
              ],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "OBJECT",
                    "name": "__EnumValue",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "inputFields",
              "description": null,
              "args": [],
              "type": {
                "kind": "LIST",
                "name": null,
                "ofType": {
                  "kind": "NON_NULL",
                  "name": null,
                  "ofType": {
                    "kind": "OBJECT",
                    "name": "__InputValue",
                    "ofType": null
                  }
                }
              },
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ofType",
              "description": null,
              "args": [],
              "type": {
                "kind": "OBJECT",
                "name": "__Type",
                "ofType": null
              },
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "inputFields": null,
          "interfaces": [],
          "enumValues": null,
          "possibleTypes": null
        },
        {
          "kind": "ENUM",
          "name": "__TypeKind",
          "description": "An enum describing what kind of type a given __Type is",
          "fields": null,
          "inputFields": null,
          "interfaces": null,
          "enumValues": [
            {
              "name": "SCALAR",
              "description": "Indicates this type is a scalar.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "OBJECT",
              "description": "Indicates this type is an object. `fields` and `interfaces` are valid fields.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INTERFACE",
              "description": "Indicates this type is an interface. `fields` and `possibleTypes` are valid fields.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "UNION",
              "description": "Indicates this type is a union. `possibleTypes` is a valid field.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "ENUM",
              "description": "Indicates this type is an enum. `enumValues` is a valid field.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "INPUT_OBJECT",
              "description": "Indicates this type is an input object. `inputFields` is a valid field.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "LIST",
              "description": "Indicates this type is a list. `ofType` is a valid field.",
              "isDeprecated": false,
              "deprecationReason": null
            },
            {
              "name": "NON_NULL",
              "description": "Indicates this type is a non-null. `ofType` is a valid field.",
              "isDeprecated": false,
              "deprecationReason": null
            }
          ],
          "possibleTypes": null
        }
      ],
      "directives": [
        {
          "name": "include",
          "description": "Directs the executor to include this field or fragment only when the `if` argument is true",
          "locations": [
            "FIELD",
            "FRAGMENT_SPREAD",
            "INLINE_FRAGMENT"
          ],
          "args": [
            {
              "name": "if",
              "description": "Included when true.",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "Boolean",
                  "ofType": null
                }
              },
              "defaultValue": null
            }
          ]
        },
        {
          "name": "skip",
          "description": "Directs the executor to skip this field or fragment when the `if`'argument is true.",
          "locations": [
            "FIELD",
            "FRAGMENT_SPREAD",
            "INLINE_FRAGMENT"
          ],
          "args": [
            {
              "name": "if",
              "description": "Skipped when true.",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "Boolean",
                  "ofType": null
                }
              },
              "defaultValue": null
            }
          ]
        },
        {
          "name": "deprecated",
          "description": "Marks the field or enum value as deprecated",
          "locations": [
            "FIELD_DEFINITION",
            "ENUM_VALUE"
          ],
          "args": [
            {
              "name": "reason",
              "description": "The reason for the deprecation",
              "type": {
                "kind": "NON_NULL",
                "name": null,
                "ofType": {
                  "kind": "SCALAR",
                  "name": "String",
                  "ofType": null
                }
              },
              "defaultValue": "\"No longer supported\""
            }
          ]
        }
      ]
    }
  }
}

6. Eşleşme Listeleme

Organizasyona ait eşleşme listeleme için aşağıdaki gibi bir mesaj yollamanız gerekmektedir. Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "effectiveDateStart": "2022-01-01 10:00:00",
  "effectiveDateEnd": "2022-01-01 14:00:00",
  "contractNames": [],
  "contractStatuses": [],
  "contractTypes": [],
  "matchId": null,
  "matchingStatus": [],
  "offerId": null,
  "offerType": null,
  "region": "TR1",
  "username": null,
  "pageInfo": {
    "page": 1,
    "size": 2
  },
  "sortingInfo": {
    "ascending": false,
    "fieldName": "time"
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "a6e65a47-5f98-4e5d-983b-4573120c587b",
  "hostName": "10.42.12.41",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 2,
        "count": 64
      },
      "matchesByOrganization": [
        {
          "time": "2022-01-01 10:31:17.632",
          "offerId": 1,
          "id": 201,
          "contract": {
            "name": "PH22010112"
          },
          "offerType": {
            "key": "BUY",
            "value": "Alış"
          },
          "status": {
            "key": "VALID",
            "value": "Geçerli"
          },
          "price": 800.00,
          "quantity": 114,
          "userName": "EPIAS",
          "region": "TR1",
          "isObjectionable": null,
          "objectionStatus": null,
          "objectionDurationInSecond": null,
          "objectionDurationEndDateTime": null
        },
        {
          "time": "2022-01-01 10:25:18.778",
          "offerId": 2,
          "id": 202,
          "contract": {
            "name": "PH22010113"
          },
          "offerType": {
            "key": "BUY",
            "value": "Alış"
          },
          "status": {
            "key": "VALID",
            "value": "Geçerli"
          },
          "price": 1056.86,
          "quantity": 167,
          "userName": "EPIAS",
          "region": "TR1",
          "isObjectionable": null,
          "objectionStatus": null,
          "objectionDurationInSecond": null,
          "objectionDurationEndDateTime": null
        }
      ]
    }
  }
}

7. Kontrat ve Tabela Listeleme

7.1. Kontrat Listeleme

Kontratları listelemek için aşağıdaki gibi bir mesaj yollamanız gerekmektedir. Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "startDate": "2023-01-31 14:00:00",
  "endDate": "2023-01-31 23:00:00",
  "contractType": "HOURLY",
  "region": "TR1",
  "statuses": [  ]
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "a57ee27c-f28e-4c05-bb27-d04ce5e211a5",
  "hostName": "10.42.11.167",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "contracts": [
        {
          "id": 728250599,
          "name": "PH23013122",
          "deliveryDateStart": "2023-01-31 22:00:00.000",
          "deliveryDateEnd": "2023-01-31 23:00:00.000",
          "duration": 1.00,
          "lastTransactionDate": "2023-01-31 21:00:00.000",
          "contractType": {
            "label": "Saatlik",
            "value": "HOURLY",
            "description": "Saatlik"
          },
          "contractKind": {
            "label": "Saatlik",
            "value": "HOURLY",
            "description": "Saatlik"
          },
          "status": {
            "label": "Aktif",
            "value": "ACTIVE",
            "description": "Aktif"
          },
          "region": {
            "label": "TR1",
            "value": "TR1",
            "description": "TR1"
          }
        },
        {
          "id": 728250600,
          "name": "PH23013123",
          "deliveryDateStart": "2023-01-31 23:00:00.000",
          "deliveryDateEnd": "2023-02-01 00:00:00.000",
          "duration": 1.00,
          "lastTransactionDate": "2023-01-31 22:00:00.000",
          "contractType": {
            "label": "Saatlik",
            "value": "HOURLY",
            "description": "Saatlik"
          },
          "contractKind": {
            "label": "Saatlik",
            "value": "HOURLY",
            "description": "Saatlik"
          },
          "status": {
            "label": "Aktif",
            "value": "ACTIVE",
            "description": "Aktif"
          },
          "region": {
            "label": "TR1",
            "value": "TR1",
            "description": "TR1"
          }
        }
      ]
    }
  }
}

7.2. İşlem Akışı Listeleme

İşlem akışlarını listelemek için aşağıdaki gibi bir mesaj yollamanız gerekmektedir.Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "effectiveDateStart": "2023-01-30 14:00:00",
  "effectiveDateEnd": "2023-01-31 14:00:00",
  "contractType": "HOURLY",
  "pageInfo": {
    "page": 1,
    "size": 10
  },
  "region": "TR1",
  "contractName": null,
  "sortingInfo": {
    "ascending": true,
    "fieldName": "time"
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "580c1906-c093-4f26-bbbc-189c11fc1568",
  "hostName": "10.42.11.167",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 1
      },
      "tradeHistories": [
        {
          "region": "TR1",
          "contractName": "PH23013109",
          "time": "2023-01-30 11:22:47.877",
          "price": 1250.00,
          "quantity": 50,
          "id": 52,
          "isOwner": false,
          "isActive": true,
          "buyerOrganizationShortName": null,
          "sellerOrganizationShortName": null
        }
      ]
    }
  }
}

7.3. Kontrat Listeleme (Tekliflerin Olduğu)

Organizasyonunuzun teklif verdiği kontratların listelendiği servis. Servis detayları için tıklayınız.

Örnek JSON İsteği
{
  "deliveryDateStart": "2022-01-30 00:00:00",
  "deliveryDateEnd": "2022-01-31 23:00:00",
  "region": "TR1",
  "contractType": null
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "16011fb3-b7c1-4092-8fd2-1bf0d3b93657",
  "hostName": "10.42.11.167",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "contracts": [
        {
          "key": "PH22013111",
          "value": "PH22013111"
        },
        {
          "key": "PH22013112",
          "value": "PH22013112"
        },
        {
          "key": "PH22013118",
          "value": "PH22013118"
        },
        {
          "key": "PH22013119",
          "value": "PH22013119"
        }
      ]
    }
  }
}

8. İtiraz Kaydetme ve Listeleme

Sistemde oluşan eşlemeler için yapılacak olan itirazlar ve kaydedilmiş olan itirazların listelenmesini sağlar.

8.1. İtiraz Kaydetme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "description": "İtirazın sebebi",
  "matchingDetailId": 13669290,
  "offerId": 16703
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f9b349a9-3673-4c4b-9926-0cda741ebedd",
  "hostName": "10.199.199.24",
  "clientIp": "127.0.0.1",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "status": true
  }
}

8.2. İtiraz Listeleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "startDate": "2023-01-29 00:00:00",
  "endDate": "2023-01-31 23:59:59",
  "status": null,
  "contractName": null,
  "pageInfo": {
    "page": 1,
    "size": 20
  },
  "sortingInfo": {
    "ascending": false,
    "fieldName": "objectionTime"
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "0b0cd0bd-6ff8-47e9-9b65-ea94f201e0fe",
  "hostName": "10.42.12.41",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 20,
        "count": 1
      },
      "objections": [
        {
          "id": 16204,
          "matchingTime": "2023-01-30 13:26:53.093",
          "offerId": 728243869,
          "matchId": 53,
          "contractName": "PH23013101",
          "matchStatus": {
            "key": "VALID",
            "value": "Geçerli"
          },
          "matchDirection": {
            "key": "BUY",
            "value": "Alış"
          },
          "matchingQuantity": 100,
          "matchingPrice": 100.00,
          "objectionTime": "2023-01-30 13:27:03.470",
          "objectionUser": "PK195",
          "description": "test",
          "reply": null,
          "replyTime": null,
          "replyUser": null,
          "objectionStatus": {
            "key": "ACTIVE",
            "value": "Aktif"
          }
        }
      ]
    }
  }
}

9. Limitler

Organizasyonun ve kullanıcılarının limit bilgilerinin yönetildiği servisler.

9.1. Organizasyon Limit Bilgisi

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "organizationId": null
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "e2461665-4cc4-4d92-8a52-5837128885eb",
  "hostName": "10.42.5.59",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "currentMaxTotalBuyUpperBound": 10000,
      "currentMaxTotalSellUpperBound": 10000
    }
  }
}

9.2. Yönetici Limit İşlemleri

9.2.1. Yönetici Limit Listeleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "organizationId": null
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "e2461665-4cc4-4d92-8a52-5837128885eb",
  "hostName": "10.42.5.59",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "currentMaxTotalBuyUpperBound": 10000,
      "currentMaxTotalSellUpperBound": 10000
    }
  }
}

9.2.2. Yönetici Limit Kaydetme/Güncelleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "maxTotalBuy": 10000,
  "maxTotalSell": 10000,
  "netStatusBuy": null,
  "netStatusSell": null,
  "maxBuyQuantity": 20000,
  "maxSellQuantity": 20000,
  "minSellPrice": 0,
  "maxBuyPrice": 10000,
  "isCheckMcp": false,
  "deviationAmount": null,
  "region": "TR1"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f9b349a9-3673-4c4b-9926-0cda741ebedd",
  "hostName": "10.199.199.24",
  "clientIp": "127.0.0.1",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "status": true
  }
}

9.3. Kullanıcı Bazında Limit Belirleme

9.3.1. Kullanıcı Üst Limitleri

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "username": "EPIAS"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "515988d3-28b5-4d30-9a93-67367ddf16e6",
  "hostName": "10.42.3.112",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "username": null,
      "region": null,
      "version": null,
      "maxTotalBuy": {
        "currentValue": 10000,
        "lowerBound": 10000,
        "upperBound": 10000
      },
      "maxTotalSell": {
        "currentValue": 10000,
        "lowerBound": 10000,
        "upperBound": 10000
      },
      "netStatusBuy": {
        "currentValue": null,
        "lowerBound": null,
        "upperBound": null
      },
      "netStatusSell": {
        "currentValue": null,
        "lowerBound": null,
        "upperBound": null
      },
      "maxBuyQuantity": {
        "currentValue": 20000,
        "lowerBound": 0,
        "upperBound": 20000
      },
      "maxSellQuantity": {
        "currentValue": 20000,
        "lowerBound": 0,
        "upperBound": 20000
      },
      "maxBuyPrice": {
        "currentValue": 10000,
        "lowerBound": 0,
        "upperBound": 10000
      },
      "minSellPrice": {
        "currentValue": 0,
        "lowerBound": 0,
        "upperBound": 10000
      },
      "isCheckMcp": false,
      "deviationAmount": null
    }
  }
}

9.3.2. Kullanıcı Üst Limit Kaydetme/Güncelleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "maxBuyQuantity": 20000,
  "maxSellQuantity": 20000,
  "minSellPrice": 0,
  "maxBuyPrice": 10000,
  "isImplementedToAllUsers": false,
  "region": "TR1",
  "isCheckMcp": false,
  "deviationAmount": null,
  "usernames": [
    "EPIAS"
  ]
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "34b2155d-d891-48d5-9388-d517f6bfc1ea",
  "hostName": "10.42.5.59",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "savedUsernames": [
        "EPIAS"
      ]
    }
  }
}

9.4. Kendi Limitlerim

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "username": "EPIAS"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "515988d3-28b5-4d30-9a93-67367ddf16e6",
  "hostName": "10.42.3.112",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "username": null,
      "region": null,
      "version": null,
      "maxTotalBuy": {
        "currentValue": 10000,
        "lowerBound": 10000,
        "upperBound": 10000
      },
      "maxTotalSell": {
        "currentValue": 10000,
        "lowerBound": 10000,
        "upperBound": 10000
      },
      "netStatusBuy": {
        "currentValue": null,
        "lowerBound": null,
        "upperBound": null
      },
      "netStatusSell": {
        "currentValue": null,
        "lowerBound": null,
        "upperBound": null
      },
      "maxBuyQuantity": {
        "currentValue": 20000,
        "lowerBound": 0,
        "upperBound": 20000
      },
      "maxSellQuantity": {
        "currentValue": 20000,
        "lowerBound": 0,
        "upperBound": 20000
      },
      "maxBuyPrice": {
        "currentValue": 10000,
        "lowerBound": 0,
        "upperBound": 10000
      },
      "minSellPrice": {
        "currentValue": 0,
        "lowerBound": 0,
        "upperBound": 10000
      },
      "isCheckMcp": false,
      "deviationAmount": null
    }
  }
}

9.4.1. Kendi Limitlerim Kaydetme/Güncelleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "maxBuyQuantity": 20000,
  "maxSellQuantity": 20000,
  "minSellPrice": 0,
  "maxBuyPrice": 10000,
  "isImplementedToAllUsers": false,
  "region": "TR1",
  "isCheckMcp": false,
  "deviationAmount": null,
  "usernames": [
    "EPIAS"
  ]
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "34b2155d-d891-48d5-9388-d517f6bfc1ea",
  "hostName": "10.42.5.59",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "savedUsernames": [
        "EPIAS"
      ]
    }
  }
}

9.5. Limit Talepleri

9.5.1. Limit Talep Listeleme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "eb94cfa7-0739-4ace-9f8b-1d322e504b71",
  "hostName": "10.42.5.59",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "demands": [
        {
          "demandId": null,
          "organizationShortName": "EPIAS",
          "organizationId": 1,
          "username": "EPIAS",
          "demandCreateDate": "2023-01-27 09:46:36.293",
          "currentMaxTotalBuyUpperBound": 0,
          "currentMaxTotalSellUpperBound": 0,
          "demandedMaxTotalBuyUpperBound": 10000,
          "demandedMaxTotalSellUpperBound": 10000,
          "approvedMaxTotalBuyUpperBound": 10000,
          "approvedMaxTotalSellUpperBound": 10000,
          "status": {
            "label": "Onaylandı",
            "value": "APPROVED",
            "description": "Onaylandı"
          },
          "participantDescription": "test",
          "approvalDate": "2023-01-27 09:47:54.362",
          "existDescription": "test"
        }
      ]
    }
  }
}

9.5.2. Limit Talep Etme

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "demandedMaxTotalBuyUpperBound": 5000,
  "demandedMaxTotalSellUpperBound": 5000,
  "participantDescription": "test",
  "region": "TR1"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f9b349a9-3673-4c4b-9926-0cda741ebedd",
  "hostName": "10.199.199.24",
  "clientIp": "127.0.0.1",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "status": true
  }
}

9.5.3. Limit Talep İptal

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "demandId": 1802
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "6fa9e1be-905e-40f9-a137-e9615cd0f470",
  "hostName": "10.42.3.228",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "status": true
    }
  }
}

9.6. Limit Geçmişi

9.6.1. Organizasyon Limit Geçmişi

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "pageInfo": {
    "page": 1,
    "size": 20
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "362d7e3d-1f5c-4711-9b40-6d393bbbb1e0",
  "hostName": "10.42.3.35",
  "clientIp": "10.199.199.14",
  "userName": "PK195",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 20,
        "count": 2
      },
      "demandHistories": [
        {
          "username": "PK195",
          "demandCreateDate": "2023-01-30 15:29:07.217",
          "demandedMaxTotalBuyUpperBound": 5000,
          "demandedMaxTotalSellUpperBound": 5000,
          "approvedMaxTotalBuyUpperBound": null,
          "approvedMaxTotalSellUpperBound": null,
          "status": {
            "label": "İptal edildi",
            "value": "CANCELLED",
            "description": "İptal edildi"
          },
          "participantDescription": "test",
          "approvalDate": "2023-01-30 15:30:22.177",
          "existDescription": null
        },
        {
          "username": "PK195",
          "demandCreateDate": "2023-01-27 09:46:36.293",
          "demandedMaxTotalBuyUpperBound": 10000,
          "demandedMaxTotalSellUpperBound": 10000,
          "approvedMaxTotalBuyUpperBound": 10000,
          "approvedMaxTotalSellUpperBound": 10000,
          "status": {
            "label": "Onaylandı",
            "value": "APPROVED",
            "description": "Onaylandı"
          },
          "participantDescription": "test",
          "approvalDate": "2023-01-27 09:47:54.362",
          "existDescription": "test"
        },
        {
          "username": "SYSTEM",
          "demandCreateDate": "2023-01-27 09:20:36.632",
          "demandedMaxTotalBuyUpperBound": 0,
          "demandedMaxTotalSellUpperBound": 0,
          "approvedMaxTotalBuyUpperBound": 0,
          "approvedMaxTotalSellUpperBound": 0,
          "status": {
            "label": "Organizasyon İlk Kayıt",
            "value": "FIRST_RECORD",
            "description": "Organizasyon İlk Kayıt"
          },
          "participantDescription": null,
          "approvalDate": null,
          "existDescription": null
        }
      ]
    }
  }
}

9.6.2. Yönetici Limit Geçmişi

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "pageInfo": {
    "page": 1,
    "size": 20
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f8083708-2194-44be-97ac-46ba6103a5ad",
  "hostName": "10.42.7.1",
  "clientIp": "10.199.199.14",
  "userName": "PK195",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 20,
        "count": 3
      },
      "upperHistories": [
        {
          "username": "PK195",
          "transactionDate": "2023-01-30 15:13:10.729",
          "maxTotalBuy": 10000,
          "maxTotalSell": 10000,
          "netStatusBuy": null,
          "netStatusSell": null,
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000.00,
          "minSellPrice": 0.00,
          "isCheckMcp": false,
          "deviationAmount": null
        },
        {
          "username": "PK195",
          "transactionDate": "2023-01-27 09:48:40.808",
          "maxTotalBuy": 10000,
          "maxTotalSell": 10000,
          "netStatusBuy": null,
          "netStatusSell": null,
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000.00,
          "minSellPrice": 0.00,
          "isCheckMcp": false,
          "deviationAmount": null
        },
        {
          "username": "SYSTEM",
          "transactionDate": "2023-01-27 09:20:36.632",
          "maxTotalBuy": 0,
          "maxTotalSell": 0,
          "netStatusBuy": null,
          "netStatusSell": null,
          "maxBuyQuantity": 0,
          "maxSellQuantity": 0,
          "maxBuyPrice": 0.00,
          "minSellPrice": 0.00,
          "isCheckMcp": false,
          "deviationAmount": null
        }
      ]
    }
  }
}

9.6.3. Kullanıcı Limit Geçmişi

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "username": "PK195",
  "pageInfo": {
    "page": 1,
    "size": 10
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "69e7533a-f078-4043-b188-fa1b7ab9ae6c",
  "hostName": "10.42.9.254",
  "clientIp": "10.199.199.14",
  "userName": "PK195",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 2
      },
      "historyList": [
        {
          "username": "PK195",
          "transactionDate": "2023-01-30 15:16:57.627",
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000,
          "minSellPrice": 0,
          "isCheckMcp": false,
          "deviationAmount": null
        },
        {
          "username": "PK195",
          "transactionDate": "2023-01-27 09:48:56.330",
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000,
          "minSellPrice": 0,
          "isCheckMcp": false,
          "deviationAmount": null
        }
      ]
    }
  }
}

9.6.4. Kendi Limit Geçmişim

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "region": "TR1",
  "pageInfo": {
    "page": 1,
    "size": 10
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "a93b09d4-fcc0-4a6e-87dc-0f2cce6c9a14",
  "hostName": "10.42.9.254",
  "clientIp": "10.199.199.14",
  "userName": "PK195",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 2
      },
      "historyList": [
        {
          "transactionDate": "2023-01-30 15:23:20.843",
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000,
          "minSellPrice": 0,
          "isCheckMcp": false,
          "deviationAmount": null
        },
        {
          "transactionDate": "2023-01-27 09:49:15.887",
          "maxBuyQuantity": 20000,
          "maxSellQuantity": 20000,
          "maxBuyPrice": 10000,
          "minSellPrice": 0,
          "isCheckMcp": false,
          "deviationAmount": null
        }
      ]
    }
  }
}

10. Raporlar

10.1. Saatlik Uzlaştırma Raporu

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "deliveryDateStart": "2023-02-01 00:00:00",
  "deliveryDateEnd": "2023-02-01 11:00:00",
  "region": "TR1",
  "pageInfo": {
    "page": 1,
    "size": 10
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f3237b45-7d16-45c0-bb72-14ddd3d1b3ed",
  "hostName": "10.42.9.254",
  "clientIp": "10.199.199.56",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 12
      },
      "items": [
        {
          "effectiveDate": "2023-02-01 00:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 01:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 02:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 03:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 04:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 05:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 06:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 07:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 08:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        },
        {
          "effectiveDate": "2023-02-01 09:00:00.000",
          "region": "TR1",
          "organizationId": 1,
          "organizationName": "EPIAS A.Ş.",
          "buyQuantity": 0.000,
          "buyAmount": 0.00,
          "sellQuantity": 0.000,
          "sellAmount": 0.00
        }
      ],
      "summary": {
        "buyQuantity": 0.000,
        "buyAmount": 0.00,
        "sellQuantity": 0.000,
        "sellAmount": 0.00
      }
    }
  }
}

10.2. TEO Raporu

Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "deliveryDateStart": "2023-10-01 21:00:00",
  "deliveryDateEnd": "2023-10-27 23:00:00",
  "region": "TR1",
  "contract": null,
  "pageInfo": {
    "page": 1,
    "size": 10
  }
}
Örnek JSON Cevabı
{
  "content": {
    "queryInformation": {
      "page": 1,
      "size": 10,
      "count": 63
    },
    "items": [
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PH23101714",
        "offerCount": 1,
        "offerUpdateCount": 2,
        "matchingCount": 0,
        "otr": 1,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 14:00:00.000",
        "lastTransactionDate": "2023-10-17 13:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PH23101716",
        "offerCount": 1,
        "offerUpdateCount": 1,
        "matchingCount": 0,
        "otr": 0,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 16:00:00.000",
        "lastTransactionDate": "2023-10-17 15:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PB23101717-18",
        "offerCount": 2,
        "offerUpdateCount": 4,
        "matchingCount": 0,
        "otr": 3,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 17:00:00.000",
        "lastTransactionDate": "2023-10-17 16:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PH23101717",
        "offerCount": 1,
        "offerUpdateCount": 2,
        "matchingCount": 1,
        "otr": 1,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 17:00:00.000",
        "lastTransactionDate": "2023-10-17 16:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PB23101718-19",
        "offerCount": 16,
        "offerUpdateCount": 32,
        "matchingCount": 0,
        "otr": 31,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 18:00:00.000",
        "lastTransactionDate": "2023-10-17 17:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PH23101718",
        "offerCount": 1,
        "offerUpdateCount": 1,
        "matchingCount": 0,
        "otr": 0,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 18:00:00.000",
        "lastTransactionDate": "2023-10-17 17:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PB23101719-20",
        "offerCount": 11,
        "offerUpdateCount": 22,
        "matchingCount": 0,
        "otr": 21,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 19:00:00.000",
        "lastTransactionDate": "2023-10-17 18:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PB23101723-24",
        "offerCount": 17,
        "offerUpdateCount": 34,
        "matchingCount": 0,
        "otr": 33,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 23:00:00.000",
        "lastTransactionDate": "2023-10-17 22:00:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PH23101723",
        "offerCount": 242,
        "offerUpdateCount": 499,
        "matchingCount": 1,
        "otr": 498,
        "limit": 0,
        "deliveryDateStart": "2023-10-17 23:00:00.000",
        "lastTransactionDate": "2023-10-17 21:50:00.000"
      },
      {
        "organizationId": 1,
        "organizationName": "TEST A.Ş.",
        "region": "TR1",
        "contractName": "PB23101810-11",
        "offerCount": 2,
        "offerUpdateCount": 4,
        "matchingCount": 0,
        "otr": 3,
        "limit": 0,
        "deliveryDateStart": "2023-10-18 10:00:00.000",
        "lastTransactionDate": "2023-10-18 09:00:00.000"
      }
    ]
  }
}

11. Websocket Mesajları Hakkında

Websocket mesajları sayesinde tekliflerinizdeki değişimleri ve kontratlarda oluşan tüm değişimleri anlık olarak dinleyebilmenizi sağlamaktadır.

Websocket mesajları mesaj tiplerine göre kategorilere ayrılmaktadır. Bu kategöriler şu şekildedir.

Table 1. Websocket Kanal İsimleri
parametre değer

HourlyContractBoard

Saatlik konratlardaki değişimleri dinleyebilmenizi sağlamaktadır.

BlockContractBoard

Blok konratlardaki değişimleri dinleyebilmenizi sağlamaktadır.

TradeHistoryChannel

Sistemde oluşan her bir eşleşmeyi dinleyebilmenizi sağlar.

OfferHistoryChannel

Firmanıza ait her bir teklif değişimlerini dinleyebilmenizi sağlar.

NetPositionChannel

Her bir kontratdaki net pozisyon bilginizi döner.

OrganizationLimitStatus

Organizasyonun saatlik limitlerindeki değişimileri dinleyebilmeniz sağlamaktadır.

ContractMessage

Sistemde yeni bir kontrat oluşması durumunda oluşan kontratın bilgilerini dinleyebilmenizi sağlar.

HourlyContractClosedMessage

Kapanan saatlik kontratlara bilgileri dinlemenizi sağlamaktadır.

BlockContractClosedMessage

Kapanan blok kontratlara bilgileri dinlemenizi sağlamaktadır.

OpenTradeDay

Yeni ticare günü başladığının bilgisini dinleyebilmenizi sağlar.

AjaxEventChannel

Kontratların pasife alınması gibi durumlarda ki değişen alanları döner.

Announcement

Sisteme eklenen yeni mesajları döner.

Notification

Uygulama tarafından atılan bildirimleri dinleyebilmenizi sağlamaktadır. Örn: yapılan itirazınız cevaplandığığında veya organizasyon limit talepleriniz kabul edildiğinde.

MatchingDetail

Eşleşmelerinize ait bilgileri anlık olarak dinleyebilmenizi sağlamaktadır.

Ping

Sistem tarafından 30 saniye bir websocket bağlantısının aktif olduğunu gösteren bir mesaj gönderilmektedir.

OrderDepth

Kontrata ait teklif derinliğindeki değişimleri dinleyebilmenizi sağlamaktadır.

OrganizationBestOffer

-

OrderDepthChart

Kontrata ait teklif derinliğinin grafiksel verilerindeki değişimlerini dinleyebilmenizi sağlamaktadır.

OrganizationSync

Organizasyonların websocket ile ilk bağlantı yaptıklarında teklif defterindeki kontratlardaki aktif alış/satış teklifleri ile birlikte teklif derinliği mesajını gönderir.

11.1. Websocket Kullanımı

Mesajları dinleyebilmeniz için adresindeki servis üzerinden kullanıcı bilgi servisi çağrılır. Gelen cevap bilgisinden websocket bağlantısı alınırarak websocket bağlantısı çağrılmalıdır.

Örnek İstek
GET /gunici-service/socket/all/5eaf94cf3572fd312345asdfe8237?jwt=eyJ1c2VyIjoiUEsxOTUiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ7XCJpZFwiOjE5NSxcImV0c29Db2RlXCI6XCI0MFgwMDAwMDAwMDAxOTVQXCIsXCJuYW1lXCI6XCJFTEVLVFLEsEsgw5xSRVTEsE0gQS7Fni5cIixcInNob3J0TmFtZVwiOlwiRcOcQcWeXCIsXCJpc0FjdGl2ZVwiOnRydWUsXCJ0eXBlXCI6XCJNQVJLRVRfUEFSVElDSVBBTlRcIixcInN1YlR5cGVcIjpcIlBST0RVQ1RJT05cIn0iLCJpYXQiOjE2Njg1OTc0OTMsImV4cCI6MTY2ODYwMDE5M30.cGcgVYs1tKcM6psCkW-ZNCAfLIQ1V5oViQGn8HblM0g HTTP/1.1
Host: gip.epias.com.tr

Websocket mesaj kanallarını filtrelemek için "event" parametresinde dinlemek istediğiniz mesajların kanal ismini vermeniz gerekmektedir. event=HourlyContractBoard&event=TradeHistoryChannel

Örnek İstek
GET /gunici-service/socket/all/5eaf94cf3572fd312345asdfe8237?jwt=eyJ1c2VyIjoiUEsxOTUiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ7XCJpZFwiOjE5NSxcImV0c29Db2RlXCI6XCI0MFgwMDAwMDAwMDAxOTVQXCIsXCJuYW1lXCI6XCJFTEVLVFLEsEsgw5xSRVTEsE0gQS7Fni5cIixcInNob3J0TmFtZVwiOlwiRcOcQcWeXCIsXCJpc0FjdGl2ZVwiOnRydWUsXCJ0eXBlXCI6XCJNQVJLRVRfUEFSVElDSVBBTlRcIixcInN1YlR5cGVcIjpcIlBST0RVQ1RJT05cIn0iLCJpYXQiOjE2Njg1OTc0OTMsImV4cCI6MTY2ODYwMDE5M30.cGcgVYs1tKcM6psCkW-ZNCAfLIQ1V5oViQGn8HblM0g&event=HourlyContractBoard&event=TradeHistoryChannel HTTP/1.1
Host: gip.epias.com.tr

11.1.1. Organizasyon Veri Senkronizasyonu

Websocket ile ilk defa bağlandığınız da sistemde işlem gören kontratlardaki aktif alış/satış tekliflerinizi ve ilgili kontratın derinliği bilgisini alabilmeniz için websocket bağlantısı yaparken organizaton-sync alanını true olarak göndermeniz gerekmektedir. Bu servis organizasyon bazında çalışmaktadır ve her bir organizasyon bu bilgiyi 10 dakika da bir alabilir. 10 dakika içinde tekrar istenilmesi durumunda herhangi bir websocket mesaj dönmeyecektir.

Örnek İstek
GET /gunici-service/socket/all/5eaf94cf3572fd312345asdfe8237?jwt=eyJ1c2VyIjoiUEsxOTUiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ7XCJpZFwiOjE5NSxcImV0c29Db2RlXCI6XCI0MFgwMDAwMDAwMDAxOTVQXCIsXCJuYW1lXCI6XCJFTEVLVFLEsEsgw5xSRVTEsE0gQS7Fni5cIixcInNob3J0TmFtZVwiOlwiRcOcQcWeXCIsXCJpc0FjdGl2ZVwiOnRydWUsXCJ0eXBlXCI6XCJNQVJLRVRfUEFSVElDSVBBTlRcIixcInN1YlR5cGVcIjpcIlBST0RVQ1RJT05cIn0iLCJpYXQiOjE2Njg1OTc0OTMsImV4cCI6MTY2ODYwMDE5M30.cGcgVYs1tKcM6psCkW-ZNCAfLIQ1V5oViQGn8HblM0g&organizaton-sync=true HTTP/1.1
Host: gip.epias.com.tr
Örnek Websocket Mesajı
{
  "eventId": "1afd3690-8383-4452-b4d3-8c1fdde9acb2",
  "id": 48,
  "time": "2023-11-02 15:50:38.005",
  "eventType": "OrganizationSync",
  "body": {
    "contracts": [
      {
        "contractName": "PH23110217",
        "region": "TR1",
        "buyOffers": [
          {
            "id": 31253,
            "price": 90,
            "quantity": 50,
            "remainingQuantity": 50,
            "contract": {
              "id": 1469,
              "name": "PH23110217",
              "deliveryDateStart": "2023-11-02 17:00:00.000",
              "deliveryDateEnd": "2023-11-02 18:00:00.000",
              "duration": 1.00,
              "lastTransactionDate": "2023-11-02 16:00:00.000",
              "contractType": "HOURLY",
              "contractKind": "HOURLY",
              "status": "ACTIVE",
              "region": "TR1",
              "hourly": true,
              "block": false,
              "active": true,
              "private": false
            },
            "offerType": "BUY",
            "status": "ACTIVE",
            "statusDetail": "YE",
            "priority": 2,
            "organizationId": 1,
            "optionType": "NORMAL",
            "version": 1,
            "username": "PKTEST",
            "updatable": true
          }
        ],
        "sellOffers": [
          {
            "id": 31252,
            "price": 100,
            "quantity": 100,
            "remainingQuantity": 100,
            "contract": {
              "id": 1469,
              "name": "PH23110217",
              "deliveryDateStart": "2023-11-02 17:00:00.000",
              "deliveryDateEnd": "2023-11-02 18:00:00.000",
              "duration": 1.00,
              "lastTransactionDate": "2023-11-02 16:00:00.000",
              "contractType": "HOURLY",
              "contractKind": "HOURLY",
              "status": "ACTIVE",
              "region": "TR1",
              "hourly": true,
              "block": false,
              "active": true,
              "private": false
            },
            "offerType": "SELL",
            "status": "ACTIVE",
            "statusDetail": "YE",
            "priority": 1,
            "organizationId": 1,
            "optionType": "NORMAL",
            "version": 1,
            "username": "PKTEST",
            "updatable": true
          }
        ],
        "orderDepth": [
          {
            "buyOrderDepth": {
              "region": "TR1",
              "price": 90.00,
              "quantity": 60,
              "isOwner": true,
              "details": [
                {
                  "quantity": 50,
                  "isOwner": true,
                  "offerId": 31253
                },
                {
                  "quantity": 10,
                  "isOwner": false,
                  "offerId": 31254
                }
              ]
            },
            "sellOrderDepth": {
              "region": "TR1",
              "price": 100.00,
              "quantity": 100,
              "isOwner": true,
              "details": [
                {
                  "quantity": 100,
                  "isOwner": true,
                  "offerId": 31252
                }
              ]
            }
          },
          {
            "buyOrderDepth": {
              "region": "TR1",
              "price": 80.00,
              "quantity": 15,
              "isOwner": false,
              "details": [
                {
                  "quantity": 15,
                  "isOwner": false,
                  "offerId": 31255
                }
              ]
            },
            "sellOrderDepth": {
              "isOwner": false,
              "details": []
            }
          }
        ]
      },
      {
        "contractName": "PH23110221",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      },
      {
        "contractName": "PH23110218",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      },
      {
        "contractName": "PH23110220",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      },
      {
        "contractName": "PH23110219",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      },
      {
        "contractName": "PH23110223",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      },
      {
        "contractName": "PH23110222",
        "region": "TR1",
        "buyOffers": [],
        "sellOffers": [],
        "orderDepth": []
      }
    ]
  }
}

11.1.2. Websocket

Websocket mesajlarında null olan alanları veya tanım değerlerini almak istememeniz durumunda websocket isteğine essential-field alanını true olarak göndermeniz gerekmektedir.

Örnek İstek
GET /gunici-service/socket/all/5eaf94cf3572fd312345asdfe8237?jwt=eyJ1c2VyIjoiUEsxOTUiLCJhbGciOiJIUzI1NiJ9.eyJzdWIiOiJ7XCJpZFwiOjE5NSxcImV0c29Db2RlXCI6XCI0MFgwMDAwMDAwMDAxOTVQXCIsXCJuYW1lXCI6XCJFTEVLVFLEsEsgw5xSRVTEsE0gQS7Fni5cIixcInNob3J0TmFtZVwiOlwiRcOcQcWeXCIsXCJpc0FjdGl2ZVwiOnRydWUsXCJ0eXBlXCI6XCJNQVJLRVRfUEFSVElDSVBBTlRcIixcInN1YlR5cGVcIjpcIlBST0RVQ1RJT05cIn0iLCJpYXQiOjE2Njg1OTc0OTMsImV4cCI6MTY2ODYwMDE5M30.cGcgVYs1tKcM6psCkW-ZNCAfLIQ1V5oViQGn8HblM0g&essential-field=true HTTP/1.1
Host: gip.epias.com.tr

11.2. HourlyContractBoard Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "301ae38a-c8a2-41d4-b379-3a42a9a58355",
  "id": 30,
  "time": "2023-02-01 13:16:55.484",
  "eventType": "HourlyContractBoard",
  "body": {
    "name": "PH23020115",
    "region": "TR1",
    "bestBuyPrice": 70,
    "bestSellPrice": 75,
    "bestBuyQuantity": 15,
    "bestSellQuantity": 75,
    "priceGap": 5,
    "boardInformation": {
      "volume": 63,
      "total": 266.900,
      "maxPrice": 50,
      "minPrice": 13,
      "maxQuantity": 50,
      "minQuantity": 13,
      "lastPrice": 13,
      "lastQuantity": 13,
      "priceChangeRate": -0.74,
      "averagePrice": 42.37,
      "mcp": 0.00,
      "lastPriceStatus": -1
    },
    "deliveryDateStart": "2023-02-01 15:00:00.000",
    "deliveryDateEnd": "2023-02-01 16:00:00.000",
    "duration": 1.00,
    "lastTransactionDate": "2023-02-01 14:00:00.000",
    "contractType": {
      "key": "HOURLY",
      "value": {
        "en": "Hourly",
        "tr": "Saatlik"
      }
    },
    "contractKind": {
      "key": "HOURLY",
      "value": {
        "en": "Hourly",
        "tr": "Saatlik"
      }
    },
    "status": {
      "key": "ACTIVE",
      "value": {
        "en": "Active",
        "tr": "Aktif"
      }
    },
    "orderDepth": [
      {
        "buyOrderDepth": {
          "price": 70.00,
          "quantity": 15
        },
        "sellOrderDepth": {
          "price": 75.00,
          "quantity": 75
        }
      }
    ]
  }
}

11.3. BlockContractBoard Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "f41933e0-59c4-4a0f-91b9-f98d2f26f871",
  "id": 30,
  "time": "2023-02-01 14:13:46.325",
  "eventType": "BlockContractBoard",
  "body": {
    "name": "PB23020116-17",
    "region": "TR1",
    "bestBuyPrice": 150,
    "bestSellPrice": null,
    "bestBuyQuantity": 100,
    "bestSellQuantity": null,
    "priceGap": null,
    "boardInformation": {
      "volume": 0,
      "total": 0,
      "maxPrice": null,
      "minPrice": null,
      "maxQuantity": null,
      "minQuantity": null,
      "lastPrice": null,
      "lastQuantity": 0,
      "priceChangeRate": null,
      "averagePrice": null,
      "mcp": 0.00,
      "lastPriceStatus": null
    },
    "deliveryDateStart": "2023-02-01 16:00:00.000",
    "deliveryDateEnd": "2023-02-01 17:00:00.000",
    "duration": 1,
    "lastTransactionDate": "2023-02-01 15:00:00.000",
    "contractType": {
      "key": "BLOCK",
      "value": {
        "en": "Block",
        "tr": "Blok"
      }
    },
    "contractKind": {
      "key": "BLOCK",
      "value": {
        "en": "Block",
        "tr": "Blok"
      }
    },
    "status": {
      "key": "ACTIVE",
      "value": {
        "en": "Active",
        "tr": "Aktif"
      }
    },
    "orderDepth": [
      {
        "buyOrderDepth": {
          "price": 150.00,
          "quantity": 100
        },
        "sellOrderDepth": {
          "price": null,
          "quantity": null
        }
      }
    ]
  }
}

11.4. TradeHistoryChannel Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "2e3d531e-708d-491f-b13d-03a44932d4c7",
  "id": 30,
  "time": "2023-02-01 14:11:42.002",
  "eventType": "TradeHistoryChannel",
  "body": {
    "region": "TR1",
    "contractName": "PQ23020115-03",
    "time": "2023-02-01 14:11:41.861",
    "price": 100,
    "quantity": 100,
    "id": 728244156,
    "isOwner": true,
    "isActive": true,
    "buyerOrganizationShortName": null,
    "sellerOrganizationShortName": null
  }
}

11.5. OfferHistoryChannel Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "3655488c-e6b0-4499-8b1b-16ab73462291",
  "id": 9,
  "time": "2023-12-26 18:15:14.907",
  "eventType": "OfferHistoryChannel",
  "body": {
    "time": "2023-12-26 18:15:14.905",
    "id": 3579749884,
    "contractName": "PH23122620",
    "offerType": {
      "key": "SELL",
      "label": "Satış",
      "value": {
        "en": "Ask",
        "tr": "Satış"
      },
      "description": {
        "en": "Ask",
        "tr": "Satış"
      }
    },
    "status": {
      "key": "ACTIVE",
      "label": "Aktif",
      "value": {
        "en": "Active",
        "tr": "Aktif"
      },
      "description": {
        "en": "Active",
        "tr": "Aktif"
      }
    },
    "statusDetail": {
      "key": "YE",
      "label": "YE",
      "value": {
        "en": "NE",
        "tr": "YE"
      },
      "description": {
        "en": "New",
        "tr": "Yeni"
      }
    },
    "price": 100,
    "quantity": 100,
    "remainingQuantity": 100,
    "remainingIcebergQuantity": null,
    "levelQuantity": null,
    "matchingPrice": null,
    "matchingQuantity": null,
    "description": null,
    "region": "TR1",
    "optionType": {
      "key": "PRICE_LEVELED",
      "label": "Fiyat Seviyeli",
      "value": {
        "en": "Price Leveled",
        "tr": "Fiyat Seviyeli"
      },
      "description": {
        "en": "Price Leveled",
        "tr": "Fiyat Seviyeli"
      }
    },
    "version": 1,
    "clientOrderId": null,
    "update": false,
    "organizationId": 195,
    "username": "PK195",
    "contract": {
      "id": 3578366164,
      "name": "PH23122620",
      "deliveryDateStart": "2023-12-26 20:00:00.000",
      "deliveryDateEnd": "2023-12-26 21:00:00.000",
      "duration": 1.00,
      "lastTransactionDate": "2023-12-26 19:00:00.000",
      "contractType": {
        "key": "HOURLY",
        "label": "Saatlik",
        "value": {
          "en": "Hourly",
          "tr": "Saatlik"
        },
        "description": {
          "en": "Hourly",
          "tr": "Saatlik"
        }
      },
      "contractKind": {
        "key": "HOURLY",
        "label": "Saatlik",
        "value": {
          "en": "Hourly",
          "tr": "Saatlik"
        },
        "description": {
          "en": "Hourly",
          "tr": "Saatlik"
        }
      },
      "status": {
        "key": "ACTIVE",
        "label": "Aktif",
        "value": {
          "en": "Active",
          "tr": "Aktif"
        },
        "description": {
          "en": "Active",
          "tr": "Aktif"
        }
      },
      "region": {
        "key": "TR1",
        "label": "TR1",
        "value": {
          "en": "TR1",
          "tr": "TR1"
        },
        "description": {
          "en": "TR1",
          "tr": "TR1"
        }
      }
    },
    "expireTime": null,
    "timeLeveledOffers": null,
    "priceLeveledOffers": [
      {
        "orderNo": 1,
        "price": 100,
        "status": {
          "key": "ACTIVE",
          "label": null,
          "value": {
            "en": "Active",
            "tr": "Aktif"
          },
          "description": {
            "en": "Active",
            "tr": "Aktif"
          }
        },
        "quantity": 100
      },
      {
        "orderNo": 2,
        "price": 101,
        "status": {
          "key": "PASSIVE",
          "label": null,
          "value": {
            "en": "Passive",
            "tr": "Pasif"
          },
          "description": {
            "en": "Passive",
            "tr": "Pasif"
          }
        },
        "quantity": 101
      },
      {
        "orderNo": 3,
        "price": 102,
        "status": {
          "key": "PASSIVE",
          "label": null,
          "value": {
            "en": "Passive",
            "tr": "Pasif"
          },
          "description": {
            "en": "Passive",
            "tr": "Pasif"
          }
        },
        "quantity": 102
      }
    ],
    "nextTimeLeveledOffer": null,
    "nextPriceLeveledOffer": {
      "orderNo": 2,
      "price": 101,
      "status": {
        "key": "PASSIVE",
        "label": "Pasif",
        "value": {
          "en": "Passive",
          "tr": "Pasif"
        },
        "description": {
          "en": "Passive",
          "tr": "Pasif"
        }
      },
      "quantity": 101
    },
    "updatable": true
  }
}

11.6. NetPositionChannel Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "1d77ff3d-cd4d-430c-a4af-38ee45cb4c13",
  "id": 30,
  "time": "2023-02-01 13:16:55.480",
  "eventType": "NetPositionChannel",
  "body": {
    "name": "PH23020115",
    "region": "TR1",
    "contractType": "HOURLY",
    "organizationStatus": {
      "buyQuantity": 0,
      "buyAmount": 0,
      "sellQuantity": 0,
      "sellAmount": 0,
      "netAmount": 0,
      "netQuantity": 0,
      "remainingBuyNetQuantity": null,
      "remainingSellNetQuantity": null,
      "otr": 0,
      "offerCount": 0,
      "matchingOfferCount": 0
    }
  }
}

11.7. OrganizationLimitStatus Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "9f84a533-cd9d-4975-9319-edbedae287f9",
  "id": 30,
  "time": "2023-02-01 13:16:55.473",
  "eventType": "OrganizationLimitStatus",
  "body": {
    "name": "PH23020115",
    "region": "TR1",
    "contractType": "HOURLY",
    "organizationNetStatusLimit": {
      "buyQuantity": 9985,
      "sellQuantity": 10000
    }
  }
}

11.8. ContractMessage Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "06235190-afe0-4470-b619-59cc7735c29c",
  "id": 30,
  "time": "2023-02-01 14:13:46.296",
  "eventType": "ContractMessage",
  "body": {
    "contract": {
      "id": 728251177,
      "name": "PB23020116-17",
      "effectiveDate": "2023-02-01 16:00:00.000",
      "effectiveDateEnd": "2023-02-01 17:00:00.000",
      "duration": 1,
      "lastTransactionDate": "2023-02-01 15:00:00.000",
      "contractType": "BLOCK",
      "contractKind": "BLOCK",
      "status": "ACTIVE",
      "region": "TR1",
      "isActive": true,
      "isHourly": false,
      "isBlock": true,
      "isPrivate": false
    }
  }
}

11.9. HourlyContractClosedMessage Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "7aa48c83-9ea1-49db-a98a-c3d745424f6f",
  "id": 30,
  "time": "2023-02-01 15:00:04.030",
  "eventType": "HourlyContractClosedMessage",
  "body": {
    "name": "PS23020116-01",
    "region": "TR1",
    "bestBuyPrice": null,
    "bestSellPrice": null,
    "bestBuyQuantity": null,
    "bestSellQuantity": null,
    "priceGap": null,
    "boardInformation": {
      "volume": 0,
      "total": 0,
      "maxPrice": null,
      "minPrice": null,
      "maxQuantity": null,
      "minQuantity": null,
      "lastPrice": null,
      "lastQuantity": 0,
      "priceChangeRate": null,
      "averagePrice": null,
      "mcp": 0.00,
      "lastPriceStatus": null
    },
    "deliveryDateStart": "2023-02-01 16:00:00.000",
    "deliveryDateEnd": "2023-02-01 16:30:00.000",
    "duration": 0.50,
    "lastTransactionDate": null,
    "contractType": {
      "key": "HOURLY",
      "value": {
        "en": "Hourly",
        "tr": "Saatlik"
      }
    },
    "contractKind": {
      "key": "SEMI",
      "value": {
        "en": "Semi",
        "tr": "Yarım"
      }
    },
    "status": {
      "key": "EXPIRE",
      "value": {
        "en": "Expire",
        "tr": "Zaman Aşımı"
      }
    },
    "orderDepth": []
  }
}

11.10. BlockContractClosedMessage Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "f19aec69-4c13-4322-95b2-1aad9040eb38",
  "id": 30,
  "time": "2023-02-01 15:00:05.874",
  "eventType": "BlockContractClosedMessage",
  "body": {
    "name": "PB23020116-17",
    "region": "TR1",
    "bestBuyPrice": null,
    "bestSellPrice": null,
    "bestBuyQuantity": null,
    "bestSellQuantity": null,
    "priceGap": null,
    "boardInformation": {
      "volume": 0,
      "total": 0,
      "maxPrice": null,
      "minPrice": null,
      "maxQuantity": null,
      "minQuantity": null,
      "lastPrice": null,
      "lastQuantity": 0,
      "priceChangeRate": null,
      "averagePrice": null,
      "mcp": 0.00,
      "lastPriceStatus": null
    },
    "deliveryDateStart": "2023-02-01 16:00:00.000",
    "deliveryDateEnd": "2023-02-01 17:00:00.000",
    "duration": 1,
    "lastTransactionDate": null,
    "contractType": {
      "key": "BLOCK",
      "value": {
        "en": "Block",
        "tr": "Blok"
      }
    },
    "contractKind": {
      "key": "BLOCK",
      "value": {
        "en": "Block",
        "tr": "Blok"
      }
    },
    "status": {
      "key": "EXPIRE",
      "value": {
        "en": "Expire",
        "tr": "Zaman Aşımı"
      }
    },
    "orderDepth": [
      {
        "buyOrderDepth": {
          "price": 150.00,
          "quantity": 100
        },
        "sellOrderDepth": {
          "price": null,
          "quantity": null
        }
      }
    ]
  }
}

11.11. OpenTradeDay Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "06235190-afe0-4470-b619-59cc7735c29c",
  "id": 30,
  "time": "2023-02-01 14:13:46.296",
  "eventType": "ContractMessage",
  "body": {
    "isOpen": true
  }
}

11.12. AjaxEventChannel Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "06235190-afe0-4470-b619-59cc7735c29c",
  "id": 30,
  "time": "2023-02-01 14:13:46.296",
  "eventType": "ContractMessage",
  "body": {
    "eventTypes": [
      "HOURLY_CONTRACT"
    ]
  }
}

11.13. Announcement Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "0ad541b3-48a3-44f4-a097-1fb765c6834f",
  "id": 30,
  "time": "2023-02-01 14:08:59.755",
  "eventType": "Announcement",
  "body": {
    "id": 52,
    "category": {
      "label": "WEB SERVİS DEĞİŞİKLİKLERİ",
      "value": "101",
      "description": null
    },
    "message": "Test duyuru",
    "time": "2023-02-01 14:08:59.606",
    "popUp": true,
    "active": true
  }
}

11.14. Notification Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "4bfd35e0-1a78-4b22-80f5-e8fd4c30e0ef",
  "id": 30,
  "time": "2023-02-01 14:09:37.537",
  "eventType": "Notification",
  "body": {
    "time": "2023-02-01 14:09:37.532",
    "message": "EPIAS kullanıcısı PH23020117 kontratındaki 728244105 ID'li eşleşmeye itiraz etmiştir."
  }
}

11.15. MatchingDetail Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "84d94501-5060-4ca1-aec8-401478ef8963",
  "id": 30,
  "time": "2023-02-01 14:07:33.987",
  "eventType": "MatchingDetail",
  "body": {
    "time": "2023-02-01 14:07:33.846",
    "offerId": 728245583,
    "id": 728244105,
    "contractName": "PH23020117",
    "offerType": {
      "key": "BUY",
      "value": {
        "en": "Buy",
        "tr": "Alış"
      },
      "description": {
        "en": "Buy",
        "tr": "Alış"
      }
    },
    "status": {
      "key": "VALID",
      "value": {
        "en": "Valid",
        "tr": "Geçerli"
      },
      "description": {
        "en": "Valid",
        "tr": "Geçerli"
      }
    },
    "price": 100,
    "quantity": 100,
    "userName": "EPIAS",
    "region": "TR1",
    "isObjectionable": true,
    "objectionStatus": null,
    "objectionDurationInSecond": 900,
    "objectionDurationEndDateTime": "2023-02-01 14:22:33.846"
  }
}

11.16. OrderDepth Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "e0d66856-c67a-4097-88b9-804781a01288",
  "id": 30,
  "time": "2023-02-01 13:16:55.486",
  "eventType": "OrderDepth",
  "body": {
    "contractName": "PH23020115",
    "region": "TR1",
    "orderDepth": [
      {
        "buyOrderDepth": {
          "region": "TR1",
          "price": 70.00,
          "quantity": 15,
          "isOwner": true,
          "details": [
            {
              "organizationShortName": null,
              "quantity": 15,
              "isOwner": true
            }
          ]
        },
        "sellOrderDepth": {
          "region": "TR1",
          "price": 75.00,
          "quantity": 75,
          "isOwner": false,
          "details": [
            {
              "organizationShortName": null,
              "quantity": 75,
              "isOwner": false
            }
          ]
        }
      }
    ]
  }
}

11.17. OrderDepthChart Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "f967e38a-063e-4581-bfb2-32225ed6192e",
  "id": 30,
  "time": "2023-02-01 13:16:55.488",
  "eventType": "OrderDepthChart",
  "body": {
    "contractName": "PH23020115",
    "region": "TR1",
    "priceGap": 5,
    "buyOrderDepthChart": [
      {
        "region": "TR1",
        "price": 0,
        "quantity": 15
      },
      {
        "region": "TR1",
        "price": 70.00,
        "quantity": 15
      }
    ],
    "sellOrderDepthChart": [
      {
        "region": "TR1",
        "price": 75.00,
        "quantity": 75
      },
      {
        "region": "TR1",
        "price": 4944,
        "quantity": 75
      }
    ]
  }
}

11.18. OrganizationBestOffer Mesaj Yapısı

Detay için tıklayınız

Örnek Mesaj Yapısı
{
  "eventId": "0ba480f3-98ff-4969-92d6-20a9730e267f",
  "id": 30,
  "time": "2023-02-01 13:16:55.489",
  "eventType": "OrganizationBestOffer",
  "body": {
    "name": "PH23020115",
    "region": "TR1",
    "bestOffer": {
      "buyOffer": {
        "offerId": 728245624,
        "price": 70,
        "quantity": 15,
        "version": 1,
        "description": null,
        "isUpdatable": true
      },
      "sellOffer": {
        "offerId": null,
        "price": null,
        "quantity": null,
        "version": null,
        "description": null,
        "isUpdatable": null
      }
    }
  }
}

11.19. Ping Mesaj Yapısı

Örnek Mesaj Yapısı
{
  "eventId": "b06e791b-daa9-4d63-88ce-f4828ef917de",
  "id": 30,
  "time": "2023-02-01 13:15:35.077",
  "eventType": "Ping",
  "body": null
}

12. Tanım Parametre Listeleme

12.1. Tanım Parametre Servisi Nasıl Çağrılır ?

Servislerde kullanılan parametrelerin aldığı değerler ve açıklamarını alabilmeniz için bu servisi kullanmanız gerekmektedir.Servis detayları için tıklayınız.

  • key alanını yollamazsanız tüm parametreler dönecektir.

Table 2. Servisin Alabileceği Değerler
parametre değer

timeLeveledOfferStatus

Zaman Seviyeli Teklif Durumları

collateralStatus

Teminat Durumları

contractStatus

Kontrat Durumları

contractType

Kontrat Tipleri

contractKind

Kontrat Türler

priceLeveledOfferStatus

Fiyat Seviyeli Teklif Durumları

matchingStatus

Eşleşme Durumları

NOTIFICATION_TYPE

Bildirim Tipleri

objectionStatus

İtiraz Durumları

offerOptionType

Teklif Opsiyon Tipleri

offerStatus

Teklif Durumları

offerStatusDetail

Teklif Durum Detayları

offerType

Teklif Yön Bilgileri

userType

Kullanıcı Tipi

operationType

İşlem Tipi

operationLogPriority

Önem Bilgisi

region

Bölgeler

AnnouncementCategory

Duyuru Kategorileri

AnnouncementStatus

Duyuru Okunma Durumları

organizationLimitDemandStatus

Limit Talep Durumları

Örnek JSON İsteği
{
  "key":"TIME_LEVELED_OFFER_STATUS"
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "8b291b4e-304e-441c-b987-f07f5c43c5e4",
  "hostName": "10.42.3.35",
  "clientIp": "10.199.199.56",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "lookups": [
        {
          "key": "region",
          "values": [
            {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            },
            {
              "label": "2",
              "value": "2",
              "description": "2"
            }
          ]
        },
        {
          "key": "AnnouncementStatus",
          "values": [
            {
              "label": "Okundu",
              "value": "READ",
              "description": "Okundu"
            },
            {
              "label": "Okunmadı",
              "value": "UNREAD",
              "description": "Okunmadı"
            }
          ]
        },
        {
          "key": "applicationServiceName",
          "values": [
            {
              "label": "IDM_TRADING_SERVICE",
              "value": "IDM_TRADING_SERVICE",
              "description": "IDM_TRADING_SERVICE"
            },
            {
              "label": "IDM_SERVICE",
              "value": "IDM_SERVICE",
              "description": "IDM_SERVICE"
            }
          ]
        },
        {
          "key": "timeLeveledOfferStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "collateralControl",
          "values": [
            {
              "label": "Yapıldı",
              "value": "DONE",
              "description": "Yapıldı"
            }
          ]
        },
        {
          "key": "collateralStatus",
          "values": [
            {
              "label": "Teminat Hesaplanmadı",
              "value": "NOT_CALCULATE",
              "description": "Teminat Hesaplanmadı"
            },
            {
              "label": "Teminat Yeterli",
              "value": "SUFFICIENT",
              "description": "Teminat Yeterli"
            },
            {
              "label": "Teminat Yetersiz",
              "value": "INSUFFICIENT",
              "description": "Teminat Yetersiz"
            },
            {
              "label": "VEP Temerrüt",
              "value": "VEP_TEMERRUT",
              "description": "VEP Temerrüt"
            }
          ]
        },
        {
          "key": "contractKind",
          "values": [
            {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            {
              "label": "Blok",
              "value": "BLOCK",
              "description": "Blok"
            },
            {
              "label": "Yarım",
              "value": "SEMI",
              "description": "Yarım"
            },
            {
              "label": "Çeyreklik",
              "value": "QUARTER",
              "description": "Çeyreklik"
            }
          ]
        },
        {
          "key": "contractStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "contractType",
          "values": [
            {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            {
              "label": "Blok",
              "value": "BLOCK",
              "description": "Blok"
            }
          ]
        },
        {
          "key": "priceLeveledOfferStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Eşleşti",
              "value": "MATCHING",
              "description": "Eşleşti"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "matchingStatus",
          "values": [
            {
              "label": "Geçerli",
              "value": "VALID",
              "description": "Geçerli"
            },
            {
              "label": "Geçersiz",
              "value": "INVALID",
              "description": "Geçersiz"
            }
          ]
        },
        {
          "key": "notificationSubject",
          "values": [
            {
              "label": "İtiraz Bildirimi",
              "value": "OBJECTION_NOTIFICATION",
              "description": "İtiraz Bildirimi"
            },
            {
              "label": "Sistem Mesajı",
              "value": "SYSTEM_MESSAGE",
              "description": "Sistem Mesajı"
            },
            {
              "label": "TPYS Gönderim Bildirimi",
              "value": "TPYS_REQUEST_NOTIFICATION",
              "description": "TPYS Gönderim Bildirimi"
            },
            {
              "label": "EPYS Gönderim Bildirimi",
              "value": "EPYS_REQUEST_NOTIFICATION",
              "description": "EPYS Gönderim Bildirimi"
            },
            {
              "label": "Teminat Rapor Bildirimi",
              "value": "COLLATERAL_REPORT_NOTIFICATION",
              "description": "Teminat Rapor Bildirimi"
            }
          ]
        },
        {
          "key": "objectionStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Kabul",
              "value": "ACCEPT",
              "description": "Kabul"
            },
            {
              "label": "Ret",
              "value": "REJECTION",
              "description": "Ret"
            }
          ]
        },
        {
          "key": "offerOptionType",
          "values": [
            {
              "label": "Normal",
              "value": "NORMAL",
              "description": "Normal"
            },
            {
              "label": "OEYE",
              "value": "IOC",
              "description": "OEYE"
            },
            {
              "label": "TEYE",
              "value": "FOK",
              "description": "TEYE"
            },
            {
              "label": "Fiyat Seviyeli",
              "value": "PRICE_LEVELED",
              "description": "Fiyat Seviyeli"
            },
            {
              "label": "Zaman Seviyeli",
              "value": "TIME_LEVELED",
              "description": "Zaman Seviyeli"
            }
          ]
        },
        {
          "key": "offerStatusDetail",
          "values": [
            {
              "label": "YE",
              "value": "YE",
              "description": "Yeni"
            },
            {
              "label": "",
              "value": "GU",
              "description": "Güncellenmiş"
            },
            {
              "label": "PA",
              "value": "PA",
              "description": "Pasif"
            },
            {
              "label": "KE",
              "value": "KE",
              "description": "Kismi Eşleşme"
            },
            {
              "label": "ZA",
              "value": "ZA",
              "description": "Zaman Aşımı"
            },
            {
              "label": "TY",
              "value": "TY",
              "description": "Teminatı Yetersiz"
            },
            {
              "label": "KA",
              "value": "KA",
              "description": "Katılım Anlaşması"
            },
            {
              "label": "İP",
              "value": "IP",
              "description": "İptal"
            },
            {
              "label": "TE",
              "value": "TE",
              "description": "Tamamı Eşleşti"
            },
            {
              "label": "İK",
              "value": "IK",
              "description": "İtiraz Kabul"
            }
          ]
        },
        {
          "key": "offerStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "Eşleşti",
              "value": "MATCHING",
              "description": "Eşleşti"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            }
          ]
        },
        {
          "key": "offerType",
          "values": [
            {
              "label": "Alış",
              "value": "BUY",
              "description": "Alış"
            },
            {
              "label": "Satış",
              "value": "SELL",
              "description": "Satış"
            }
          ]
        },
        {
          "key": "operationLogPriority",
          "values": [
            {
              "label": "Bilgi",
              "value": "INFO",
              "description": "Bilgi"
            },
            {
              "label": "Uyarı",
              "value": "WARNING",
              "description": "Uyarı"
            },
            {
              "label": "Hata",
              "value": "ERROR",
              "description": "Hata"
            }
          ]
        },
        {
          "key": "operationType",
          "values": [
            {
              "label": "Kullanıcı",
              "value": "USER",
              "description": "Kullanıcı"
            },
            {
              "label": "Sistem",
              "value": "SYSTEM",
              "description": "Sistem"
            }
          ]
        },
        {
          "key": "organizationLimitDemandStatus",
          "values": [
            {
              "label": "Organizasyon İlk Kayıt",
              "value": "FIRST_RECORD",
              "description": "Organizasyon İlk Kayıt"
            },
            {
              "label": "Beklemede",
              "value": "WAITING",
              "description": "Beklemede"
            },
            {
              "label": "Onaylandı",
              "value": "APPROVED",
              "description": "Onaylandı"
            },
            {
              "label": "Reddedildi",
              "value": "REJECTED",
              "description": "Reddedildi"
            },
            {
              "label": "İptal edildi",
              "value": "CANCELLED",
              "description": "İptal edildi"
            }
          ]
        },
        {
          "key": "participationStatus",
          "values": [
            {
              "label": "Var",
              "value": "THERE_IS",
              "description": "Var"
            },
            {
              "label": "Yok",
              "value": "THERE_IS_NOT",
              "description": "Yok"
            }
          ]
        }
      ],
      "active": [
        {
          "key": "region",
          "values": [
            {
              "label": "TR1",
              "value": "TR1",
              "description": "TR1"
            },
            {
              "label": "2",
              "value": "2",
              "description": "2"
            }
          ]
        },
        {
          "key": "AnnouncementStatus",
          "values": [
            {
              "label": "Okundu",
              "value": "READ",
              "description": "Okundu"
            },
            {
              "label": "Okunmadı",
              "value": "UNREAD",
              "description": "Okunmadı"
            }
          ]
        },
        {
          "key": "applicationServiceName",
          "values": [
            {
              "label": "IDM_TRADING_SERVICE",
              "value": "IDM_TRADING_SERVICE",
              "description": "IDM_TRADING_SERVICE"
            },
            {
              "label": "IDM_SERVICE",
              "value": "IDM_SERVICE",
              "description": "IDM_SERVICE"
            }
          ]
        },
        {
          "key": "timeLeveledOfferStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "collateralControl",
          "values": [
            {
              "label": "Yapıldı",
              "value": "DONE",
              "description": "Yapıldı"
            }
          ]
        },
        {
          "key": "collateralStatus",
          "values": [
            {
              "label": "Teminat Hesaplanmadı",
              "value": "NOT_CALCULATE",
              "description": "Teminat Hesaplanmadı"
            },
            {
              "label": "Teminat Yeterli",
              "value": "SUFFICIENT",
              "description": "Teminat Yeterli"
            },
            {
              "label": "Teminat Yetersiz",
              "value": "INSUFFICIENT",
              "description": "Teminat Yetersiz"
            },
            {
              "label": "VEP Temerrüt",
              "value": "VEP_TEMERRUT",
              "description": "VEP Temerrüt"
            }
          ]
        },
        {
          "key": "contractKind",
          "values": [
            {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            {
              "label": "Blok",
              "value": "BLOCK",
              "description": "Blok"
            },
            {
              "label": "Yarım",
              "value": "SEMI",
              "description": "Yarım"
            },
            {
              "label": "Çeyreklik",
              "value": "QUARTER",
              "description": "Çeyreklik"
            }
          ]
        },
        {
          "key": "contractStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "contractType",
          "values": [
            {
              "label": "Saatlik",
              "value": "HOURLY",
              "description": "Saatlik"
            },
            {
              "label": "Blok",
              "value": "BLOCK",
              "description": "Blok"
            }
          ]
        },
        {
          "key": "priceLeveledOfferStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Eşleşti",
              "value": "MATCHING",
              "description": "Eşleşti"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            },
            {
              "label": "Zaman Aşımı",
              "value": "EXPIRE",
              "description": "Zaman Aşımı"
            }
          ]
        },
        {
          "key": "matchingStatus",
          "values": [
            {
              "label": "Geçerli",
              "value": "VALID",
              "description": "Geçerli"
            },
            {
              "label": "Geçersiz",
              "value": "INVALID",
              "description": "Geçersiz"
            }
          ]
        },
        {
          "key": "notificationSubject",
          "values": [
            {
              "label": "İtiraz Bildirimi",
              "value": "OBJECTION_NOTIFICATION",
              "description": "İtiraz Bildirimi"
            },
            {
              "label": "Sistem Mesajı",
              "value": "SYSTEM_MESSAGE",
              "description": "Sistem Mesajı"
            },
            {
              "label": "TPYS Gönderim Bildirimi",
              "value": "TPYS_REQUEST_NOTIFICATION",
              "description": "TPYS Gönderim Bildirimi"
            },
            {
              "label": "EPYS Gönderim Bildirimi",
              "value": "EPYS_REQUEST_NOTIFICATION",
              "description": "EPYS Gönderim Bildirimi"
            },
            {
              "label": "Teminat Rapor Bildirimi",
              "value": "COLLATERAL_REPORT_NOTIFICATION",
              "description": "Teminat Rapor Bildirimi"
            }
          ]
        },
        {
          "key": "objectionStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Kabul",
              "value": "ACCEPT",
              "description": "Kabul"
            },
            {
              "label": "Ret",
              "value": "REJECTION",
              "description": "Ret"
            }
          ]
        },
        {
          "key": "offerOptionType",
          "values": [
            {
              "label": "Normal",
              "value": "NORMAL",
              "description": "Normal"
            },
            {
              "label": "OEYE",
              "value": "IOC",
              "description": "OEYE"
            },
            {
              "label": "TEYE",
              "value": "FOK",
              "description": "TEYE"
            },
            {
              "label": "Fiyat Seviyeli",
              "value": "PRICE_LEVELED",
              "description": "Fiyat Seviyeli"
            },
            {
              "label": "Zaman Aralıklı",
              "value": "TIME_LEVELED",
              "description": "Zaman Aralıklı"
            }
          ]
        },
        {
          "key": "offerStatusDetail",
          "values": [
            {
              "label": "YE",
              "value": "YE",
              "description": "Yeni"
            },
            {
              "label": "",
              "value": "GU",
              "description": "Güncellenmiş"
            },
            {
              "label": "PA",
              "value": "PA",
              "description": "Pasif"
            },
            {
              "label": "KE",
              "value": "KE",
              "description": "Kismi Eşleşme"
            },
            {
              "label": "ZA",
              "value": "ZA",
              "description": "Zaman Aşımı"
            },
            {
              "label": "TY",
              "value": "TY",
              "description": "Teminatı Yetersiz"
            },
            {
              "label": "KA",
              "value": "KA",
              "description": "Katılım Anlaşması"
            },
            {
              "label": "İP",
              "value": "IP",
              "description": "İptal"
            },
            {
              "label": "TE",
              "value": "TE",
              "description": "Tamamı Eşleşti"
            },
            {
              "label": "İK",
              "value": "IK",
              "description": "İtiraz Kabul"
            }
          ]
        },
        {
          "key": "offerStatus",
          "values": [
            {
              "label": "Aktif",
              "value": "ACTIVE",
              "description": "Aktif"
            },
            {
              "label": "Pasif",
              "value": "PASSIVE",
              "description": "Pasif"
            },
            {
              "label": "Eşleşti",
              "value": "MATCHING",
              "description": "Eşleşti"
            },
            {
              "label": "İptal",
              "value": "CANCEL",
              "description": "İptal"
            }
          ]
        },
        {
          "key": "offerType",
          "values": [
            {
              "label": "Alış",
              "value": "BUY",
              "description": "Alış"
            },
            {
              "label": "Satış",
              "value": "SELL",
              "description": "Satış"
            }
          ]
        },
        {
          "key": "operationLogPriority",
          "values": [
            {
              "label": "Bilgi",
              "value": "INFO",
              "description": "Bilgi"
            },
            {
              "label": "Uyarı",
              "value": "WARNING",
              "description": "Uyarı"
            },
            {
              "label": "Hata",
              "value": "ERROR",
              "description": "Hata"
            }
          ]
        },
        {
          "key": "operationType",
          "values": [
            {
              "label": "Kullanıcı",
              "value": "USER",
              "description": "Kullanıcı"
            },
            {
              "label": "Sistem",
              "value": "SYSTEM",
              "description": "Sistem"
            }
          ]
        },
        {
          "key": "organizationLimitDemandStatus",
          "values": [
            {
              "label": "Organizasyon İlk Kayıt",
              "value": "FIRST_RECORD",
              "description": "Organizasyon İlk Kayıt"
            },
            {
              "label": "Beklemede",
              "value": "WAITING",
              "description": "Beklemede"
            },
            {
              "label": "Onaylandı",
              "value": "APPROVED",
              "description": "Onaylandı"
            },
            {
              "label": "Reddedildi",
              "value": "REJECTED",
              "description": "Reddedildi"
            },
            {
              "label": "İptal edildi",
              "value": "CANCELLED",
              "description": "İptal edildi"
            }
          ]
        },
        {
          "key": "participationStatus",
          "values": [
            {
              "label": "Var",
              "value": "THERE_IS",
              "description": "Var"
            },
            {
              "label": "Yok",
              "value": "THERE_IS_NOT",
              "description": "Yok"
            }
          ]
        }
      ]
    }
  }
}

13. Duyuru Listeleme

Piyasa yöneticisi tarafından yapılan duyuruların listelendiği servis.

13.1. Kategori Listeleme

Duyurların ait olduğu kategori listesini çekmek için aşağıdaki gibi bir istek yapmanız gerekmektedir.Servis detayı için tıklayınız.

Örnek HTTP İsteği
GET /gunici-service/rest/v1/announcement/category/list HTTP/1.1
Host:  gip.epias.com.tr
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "32f34529-cec9-4e53-a9f1-80e923b63023",
  "hostName": "10.42.12.41",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "categories": [
        {
          "label": "EPİAŞ PLANLI BAKIM ÇALIŞMASI",
          "value": "1",
          "description": null
        },
        {
          "label": "TEİAŞ PLANLI BAKIM ÇALIŞMASI",
          "value": "51",
          "description": null
        },
        {
          "label": "WEB SERVİS DEĞİŞİKLİKLERİ",
          "value": "101",
          "description": null
        },
        {
          "label": "ÇAĞRI MERKEZİ PLANLI BAKIM ÇALIŞMASI",
          "value": "151",
          "description": null
        },
        {
          "label": "PİYASA İŞLEM LİMİTLERİ",
          "value": "201",
          "description": null
        }
      ]
    }
  }
}

13.2. Duyuru Listeleme

Piyasa işletmeni tarafından sisteme girilen duyurların listesini alabilmeniz için aşağıdaki gibi bir istek girmeniz gerekmektedir. Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "startDate": "2023-01-30 00:00:00",
  "endDate": "2023-01-31 00:00:00",
  "categories":[],
  "pageInfo": {
    "size": "10",
    "page": 1
  }
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "661b6227-23dc-4364-a76a-a8c42cbcebd1",
  "hostName": "10.42.11.167",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "queryInformation": {
        "page": 1,
        "size": 10,
        "count": 1
      },
      "announcements": [
        {
          "id": 1,
          "category": {
            "label": "EPİAŞ PLANLI BAKIM ÇALIŞMASI",
            "value": "1",
            "description": null
          },
          "message": "TEST DUYURUSU",
          "startTime": "2023-01-30 11:35:13.922",
          "endTime": "2023-02-05 11:31:00.000",
          "createTime": "2023-01-30 11:35:13.923",
          "announcementStatus": {
            "label": "Okunmadı",
            "value": "UNREAD",
            "description": null
          }
        }
      ]
    }
  }
}

13.3. Okunmamış Mesaj Listeleme

Sistemde okunmamış durumdaki mesajları alabilmeniz için aşağıdaki gibi istek yapmanız gerekmektedir. Servis detayı için tıklayınız.

Örnek HTTP İsteği
GET /gunici-service/rest/v1/announcement/unread/get HTTP/1.1
Host:  gip.epias.com.tr
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "52291643-406a-4383-8b55-97d854db1894",
  "hostName": "10.42.3.103",
  "clientIp": "10.199.199.35",
  "userName": "EPIAS",
  "errors": null,
  "body": {
    "content": {
      "announcements": [
        {
          "id": 1,
          "category": {
            "label": "EPİAŞ PLANLI BAKIM ÇALIŞMASI",
            "value": "1",
            "description": null
          },
          "message": "TEST DUYURUSU",
          "time": null,
          "popUp": false
        }
      ]
    }
  }
}

13.4. Okunmamış Mesaj Güncelleme

Okunmamış mesajları okundu durumuna çekmek için aşağıdaki gibi bir istek yapmanız gerekmektedir.Servis detayı için tıklayınız.

Örnek JSON İsteği
{
  "messages": [
    152,
    153
  ]
}
Örnek JSON Cevabı
{
  "status": "200 OK",
  "txId": "f9b349a9-3673-4c4b-9926-0cda741ebedd",
  "hostName":