{
  "openapi": "3.0.3",
  "info": {
    "title": "VOIS SMS API",
    "version": "1.1.0",
    "description": "Tam doküman: https://docs.vois.com.tr/sms/\n\nKimlik doğrulama: iki yöntem. (1) VOIS tarafından verilen API kullanıcı adı ve şifresiyle HTTP Basic (/sms/… uçları). (2) VOIS API anahtarıyla Bearer (/v1/sms/… uçları, \"VOIS anahtarı\" etiketi; yetkiler sms:send, sms:read). Ayrıntı: https://docs.vois.com.tr/sms/#vois-anahtari\n\nDestek: destek@vois.com.tr · 0850 340 6 340",
    "contact": {
      "name": "VOIS Destek",
      "email": "destek@vois.com.tr",
      "url": "https://docs.vois.com.tr/"
    }
  },
  "servers": [
    {
      "url": "https://api.vois.com.tr"
    }
  ],
  "security": [
    {
      "basicAuth": []
    }
  ],
  "tags": [
    {
      "name": "Gönderim"
    },
    {
      "name": "Raporlama"
    },
    {
      "name": "Hesap"
    },
    {
      "name": "VOIS anahtarı"
    }
  ],
  "paths": {
    "/sms/create": {
      "post": {
        "tags": [
          "Gönderim"
        ],
        "summary": "Tekil SMS",
        "description": "Tekil, çoklu, kişiye özel SMS ve MMS gönderimi. ⚠️ Gerçek gönderim yapar ve kredi harcar.\n\nDoküman: https://docs.vois.com.tr/sms/#single",
        "operationId": "single",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "title": "Tekil SMS (sendingType 0)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "number",
                      "content"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          0
                        ]
                      },
                      "number": {
                        "type": "string"
                      },
                      "content": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "title": "Çoklu SMS / MMS (sendingType 1)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "numbers",
                      "content"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          1
                        ]
                      },
                      "numbers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "content": {
                        "type": "string"
                      },
                      "subject": {
                        "type": "string",
                        "description": "MMS konu başlığı."
                      },
                      "media": {
                        "type": "object",
                        "description": "MMS dosyası.",
                        "properties": {
                          "ext": {
                            "type": "string"
                          },
                          "mimeType": {
                            "type": "string"
                          },
                          "data": {
                            "type": "string",
                            "description": "Base64"
                          }
                        }
                      }
                    }
                  },
                  {
                    "title": "Kişiye özel SMS (sendingType 2)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "numbers"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          2
                        ]
                      },
                      "numbers": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "nr",
                            "msg"
                          ],
                          "properties": {
                            "nr": {
                              "type": "string"
                            },
                            "msg": {
                              "type": "string"
                            },
                            "xid": {
                              "type": "string",
                              "maxLength": 32
                            }
                          }
                        }
                      }
                    }
                  }
                ]
              },
              "examples": {
                "Tekil": {
                  "value": {
                    "type": 1,
                    "sendingType": 0,
                    "title": "Randevu hatirlatma",
                    "content": "Yarın 10:00 randevunuzu hatırlatırız.",
                    "number": "905321234567",
                    "sender": "BASLIK",
                    "encoding": 1,
                    "validity": 1440,
                    "commercial": false,
                    "customID": "randevu-20261110-0042"
                  }
                },
                "Çoklu": {
                  "value": {
                    "type": 1,
                    "sendingType": 1,
                    "title": "Kasim kampanyasi",
                    "content": "Kasım'a özel %20 indirim! Ret için RET yazıp gönderin.",
                    "numbers": [
                      "905321234567",
                      "905441234567"
                    ],
                    "sender": "BASLIK",
                    "encoding": 1,
                    "commercial": true,
                    "sendingDate": "2026-11-15 10:00"
                  }
                },
                "Kişiye özel": {
                  "value": {
                    "type": 1,
                    "sendingType": 2,
                    "title": "Fatura bildirimi",
                    "numbers": [
                      {
                        "nr": "905321234567",
                        "msg": "Sayın Ayşe Hanım, 1.250 TL faturanız oluştu.",
                        "xid": "F-1001"
                      },
                      {
                        "nr": "905441234567",
                        "msg": "Sayın Mehmet Bey, 980 TL faturanız oluştu.",
                        "xid": "F-1002"
                      }
                    ],
                    "sender": "BASLIK",
                    "encoding": 1,
                    "commercial": false
                  }
                },
                "MMS": {
                  "value": {
                    "type": 4,
                    "sendingType": 1,
                    "title": "Yeni sezon katalog",
                    "subject": "Yeni sezon",
                    "content": "Yeni sezon ürünlerimiz mağazalarda!",
                    "numbers": [
                      "905321234567"
                    ],
                    "sender": "BASLIK",
                    "commercial": true,
                    "media": {
                      "ext": "jpg",
                      "mimeType": "image/jpeg",
                      "data": "BASE64_DOSYA_ICERIGI"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/create-otp": {
      "post": {
        "tags": [
          "Gönderim"
        ],
        "summary": "OTP SMS",
        "description": "Öncelikli tek kullanımlık kod gönderimi. ⚠️ Gerçek gönderim yapar ve kredi harcar.\n\nDoküman: https://docs.vois.com.tr/sms/#otp",
        "operationId": "otp",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "number",
                  "sender",
                  "content"
                ],
                "properties": {
                  "number": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "content": {
                    "type": "string"
                  },
                  "encoding": {
                    "type": "integer",
                    "enum": [
                      0,
                      1,
                      2
                    ],
                    "description": "0 Standart, 1 Türkçe, 2 Unicode."
                  },
                  "validity": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 6
                  },
                  "commercial": {
                    "type": "boolean"
                  },
                  "customID": {
                    "type": "string"
                  },
                  "trustDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00:00",
                    "description": "SIM değişikliği kontrolü, yyyy-MM-dd HH:mm:ss."
                  },
                  "pushSettings": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              },
              "examples": {
                "OTP": {
                  "value": {
                    "number": "905321234567",
                    "sender": "BASLIK",
                    "content": "Doğrulama kodunuz: 482915",
                    "encoding": 1,
                    "validity": 3,
                    "commercial": false,
                    "customID": "otp-7731"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/cancel": {
      "post": {
        "tags": [
          "Gönderim"
        ],
        "summary": "İleri tarihli gönderimi iptal",
        "description": "Henüz gönderilmemiş ileri tarihli paketi iptal eder.\n\nDoküman: https://docs.vois.com.tr/sms/#cancel",
        "operationId": "cancel",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "pkgID"
                  },
                  "customID": {
                    "type": "string"
                  }
                }
              },
              "examples": {
                "pkgID ile": {
                  "value": {
                    "id": 48213390
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/list": {
      "post": {
        "tags": [
          "Raporlama"
        ],
        "summary": "Paket raporu",
        "description": "Paketlerin durumu ve istatistikleri.\n\nDoküman: https://docs.vois.com.tr/sms/#report",
        "operationId": "report",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "startDate",
                  "finishDate",
                  "pageIndex",
                  "pageSize"
                ],
                "properties": {
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  },
                  "ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  },
                  "customIDs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "keyword": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "status": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "Tarih aralığı": {
                  "value": {
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59",
                    "pageIndex": 0,
                    "pageSize": 50
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/list-item": {
      "post": {
        "tags": [
          "Raporlama"
        ],
        "summary": "Numara bazlı rapor",
        "description": "Bir paketteki her numaranın teslim durumu. pkgID ya da customID zorunlu.\n\nDoküman: https://docs.vois.com.tr/sms/#detail",
        "operationId": "detail",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pkgID": {
                    "type": "integer"
                  },
                  "customID": {
                    "type": "string"
                  },
                  "target": {
                    "type": "string"
                  },
                  "operator": {
                    "type": "integer"
                  },
                  "state": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "pkgID ile": {
                  "value": {
                    "pkgID": 48213402,
                    "pageIndex": 0,
                    "pageSize": 100
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/summary": {
      "post": {
        "tags": [
          "Raporlama"
        ],
        "summary": "Özet istatistik",
        "description": "Tarih aralığındaki toplamlar.\n\nDoküman: https://docs.vois.com.tr/sms/#summary",
        "operationId": "summary",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "startDate",
                  "finishDate"
                ],
                "properties": {
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  }
                }
              },
              "examples": {
                "Kasım": {
                  "value": {
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-30 23:59"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/inquiry-number": {
      "post": {
        "tags": [
          "Raporlama"
        ],
        "summary": "Numara sorgulama",
        "description": "Bir numaraya geçmişte gönderilen mesajlar.\n\nDoküman: https://docs.vois.com.tr/sms/#inquiry",
        "operationId": "inquiry",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "gsm"
                ],
                "properties": {
                  "gsm": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  }
                }
              },
              "examples": {
                "Numara": {
                  "value": {
                    "gsm": "905321234567",
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/user/credit": {
      "get": {
        "tags": [
          "Hesap"
        ],
        "summary": "Bakiye",
        "description": "Kalan kredi. SMS göndermez — bağlantı testi için idealdir.\n\nDoküman: https://docs.vois.com.tr/sms/#credit",
        "operationId": "credit",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        }
      }
    },
    "/sms/list-sender": {
      "post": {
        "tags": [
          "Hesap"
        ],
        "summary": "Gönderen başlıkları",
        "description": "Tanımlı başlıklar ve onay durumları (status 1 = onaylı).\n\nDoküman: https://docs.vois.com.tr/sms/#senders",
        "operationId": "senders",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string"
                  },
                  "status": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "İlk sayfa": {
                  "value": {
                    "pageIndex": 0,
                    "pageSize": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/sms/list-gateway": {
      "get": {
        "tags": [
          "Hesap"
        ],
        "summary": "Ağ geçitleri",
        "description": "Hesaba tanımlı ağ geçitleri.\n\nDoküman: https://docs.vois.com.tr/sms/#gateways",
        "operationId": "gateways",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        }
      }
    },
    "/mo/list-request": {
      "post": {
        "tags": [
          "Hesap"
        ],
        "summary": "Gelen SMS (MO)",
        "description": "Kısa numaranıza gelen mesajlar.\n\nDoküman: https://docs.vois.com.tr/sms/#mo",
        "operationId": "mo",
        "responses": {
          "200": {
            "description": "Başarılı ya da hatalı yanıt (`err` alanına bakın).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Kimlik bilgisi hatalı ya da IP kısıtı (ERR_UNAUTHORIZED_REQUEST).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "417": {
            "description": "Doğrulama hatası (ör. ERR_INVALID_PARAM, ERR_USER_CREDIT_REQUIRED).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "429": {
            "description": "İstek sınırı aşıldı."
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string"
                  },
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "RET": {
                  "value": {
                    "keyword": "RET",
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59",
                    "pageIndex": 0,
                    "pageSize": 100
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/create": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Tekil SMS (anahtarla)",
        "operationId": "key_single",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Tekil, çoklu, kişiye özel SMS ve MMS gönderimi. ⚠️ Gerçek gönderim yapar ve kredi harcar.\n\nYetki: sms:send. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "oneOf": [
                  {
                    "title": "Tekil SMS (sendingType 0)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "number",
                      "content"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          0
                        ]
                      },
                      "number": {
                        "type": "string"
                      },
                      "content": {
                        "type": "string"
                      }
                    }
                  },
                  {
                    "title": "Çoklu SMS / MMS (sendingType 1)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "numbers",
                      "content"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          1
                        ]
                      },
                      "numbers": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      },
                      "content": {
                        "type": "string"
                      },
                      "subject": {
                        "type": "string",
                        "description": "MMS konu başlığı."
                      },
                      "media": {
                        "type": "object",
                        "description": "MMS dosyası.",
                        "properties": {
                          "ext": {
                            "type": "string"
                          },
                          "mimeType": {
                            "type": "string"
                          },
                          "data": {
                            "type": "string",
                            "description": "Base64"
                          }
                        }
                      }
                    }
                  },
                  {
                    "title": "Kişiye özel SMS (sendingType 2)",
                    "type": "object",
                    "required": [
                      "type",
                      "sendingType",
                      "title",
                      "sender",
                      "numbers"
                    ],
                    "properties": {
                      "type": {
                        "type": "integer",
                        "enum": [
                          1,
                          4
                        ],
                        "description": "Mesaj tipi: 1 SMS, 4 MMS."
                      },
                      "title": {
                        "type": "string",
                        "minLength": 5,
                        "maxLength": 50,
                        "description": "Paket adı (alıcıya gitmez)."
                      },
                      "sender": {
                        "type": "string",
                        "description": "Onaylı gönderen başlığı."
                      },
                      "encoding": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Standart, 1 Türkçe, 2 Unicode."
                      },
                      "validity": {
                        "type": "integer",
                        "minimum": 60,
                        "maximum": 1440,
                        "description": "Geçerlilik süresi (dakika). Varsayılan 1440."
                      },
                      "sendingDate": {
                        "type": "string",
                        "example": "2026-11-15 10:00",
                        "description": "İleri tarihli gönderim, yyyy-MM-dd HH:mm."
                      },
                      "commercial": {
                        "type": "boolean",
                        "description": "Ticari ileti ise true (İYS kontrolü)."
                      },
                      "skipAhsQuery": {
                        "type": "boolean"
                      },
                      "recipientType": {
                        "type": "integer",
                        "enum": [
                          0,
                          1,
                          2
                        ],
                        "description": "0 Bireysel, 1 Tacir, 2 Her ikisi."
                      },
                      "gateway": {
                        "type": "string",
                        "format": "uuid"
                      },
                      "customID": {
                        "type": "string",
                        "maxLength": 100,
                        "description": "Kendi kayıt numaranız."
                      },
                      "pushSettings": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string",
                            "format": "uri"
                          }
                        }
                      },
                      "periodicSettings": {
                        "type": "object",
                        "description": "Yalnız çoklu ve kişiye özel gönderimde.",
                        "properties": {
                          "periodType": {
                            "type": "integer",
                            "enum": [
                              0
                            ]
                          },
                          "interval": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        }
                      },
                      "sendingType": {
                        "type": "integer",
                        "enum": [
                          2
                        ]
                      },
                      "numbers": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "nr",
                            "msg"
                          ],
                          "properties": {
                            "nr": {
                              "type": "string"
                            },
                            "msg": {
                              "type": "string"
                            },
                            "xid": {
                              "type": "string",
                              "maxLength": 32
                            }
                          }
                        }
                      }
                    }
                  }
                ]
              },
              "examples": {
                "Tekil": {
                  "value": {
                    "type": 1,
                    "sendingType": 0,
                    "title": "Randevu hatirlatma",
                    "content": "Yarın 10:00 randevunuzu hatırlatırız.",
                    "number": "905321234567",
                    "sender": "BASLIK",
                    "encoding": 1,
                    "validity": 1440,
                    "commercial": false,
                    "customID": "randevu-20261110-0042"
                  }
                },
                "Çoklu": {
                  "value": {
                    "type": 1,
                    "sendingType": 1,
                    "title": "Kasim kampanyasi",
                    "content": "Kasım'a özel %20 indirim! Ret için RET yazıp gönderin.",
                    "numbers": [
                      "905321234567",
                      "905441234567"
                    ],
                    "sender": "BASLIK",
                    "encoding": 1,
                    "commercial": true,
                    "sendingDate": "2026-11-15 10:00"
                  }
                },
                "Kişiye özel": {
                  "value": {
                    "type": 1,
                    "sendingType": 2,
                    "title": "Fatura bildirimi",
                    "numbers": [
                      {
                        "nr": "905321234567",
                        "msg": "Sayın Ayşe Hanım, 1.250 TL faturanız oluştu.",
                        "xid": "F-1001"
                      },
                      {
                        "nr": "905441234567",
                        "msg": "Sayın Mehmet Bey, 980 TL faturanız oluştu.",
                        "xid": "F-1002"
                      }
                    ],
                    "sender": "BASLIK",
                    "encoding": 1,
                    "commercial": false
                  }
                },
                "MMS": {
                  "value": {
                    "type": 4,
                    "sendingType": 1,
                    "title": "Yeni sezon katalog",
                    "subject": "Yeni sezon",
                    "content": "Yeni sezon ürünlerimiz mağazalarda!",
                    "numbers": [
                      "905321234567"
                    ],
                    "sender": "BASLIK",
                    "commercial": true,
                    "media": {
                      "ext": "jpg",
                      "mimeType": "image/jpeg",
                      "data": "BASE64_DOSYA_ICERIGI"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/create-otp": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "OTP SMS (anahtarla)",
        "operationId": "key_otp",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Öncelikli tek kullanımlık kod gönderimi. ⚠️ Gerçek gönderim yapar ve kredi harcar.\n\nYetki: sms:send. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "number",
                  "sender",
                  "content"
                ],
                "properties": {
                  "number": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "content": {
                    "type": "string"
                  },
                  "encoding": {
                    "type": "integer",
                    "enum": [
                      0,
                      1,
                      2
                    ],
                    "description": "0 Standart, 1 Türkçe, 2 Unicode."
                  },
                  "validity": {
                    "type": "integer",
                    "minimum": 3,
                    "maximum": 6
                  },
                  "commercial": {
                    "type": "boolean"
                  },
                  "customID": {
                    "type": "string"
                  },
                  "trustDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00:00",
                    "description": "SIM değişikliği kontrolü, yyyy-MM-dd HH:mm:ss."
                  },
                  "pushSettings": {
                    "type": "object",
                    "properties": {
                      "url": {
                        "type": "string",
                        "format": "uri"
                      }
                    }
                  }
                }
              },
              "examples": {
                "OTP": {
                  "value": {
                    "number": "905321234567",
                    "sender": "BASLIK",
                    "content": "Doğrulama kodunuz: 482915",
                    "encoding": 1,
                    "validity": 3,
                    "commercial": false,
                    "customID": "otp-7731"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/cancel": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "İleri tarihli gönderimi iptal (anahtarla)",
        "operationId": "key_cancel",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Henüz gönderilmemiş ileri tarihli paketi iptal eder.\n\nYetki: sms:send. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "integer",
                    "description": "pkgID"
                  },
                  "customID": {
                    "type": "string"
                  }
                }
              },
              "examples": {
                "pkgID ile": {
                  "value": {
                    "id": 48213390
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/list": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Paket raporu (anahtarla)",
        "operationId": "key_report",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Paketlerin durumu ve istatistikleri.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "startDate",
                  "finishDate",
                  "pageIndex",
                  "pageSize"
                ],
                "properties": {
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  },
                  "ids": {
                    "type": "array",
                    "items": {
                      "type": "integer"
                    }
                  },
                  "customIDs": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "keyword": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "status": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "Tarih aralığı": {
                  "value": {
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59",
                    "pageIndex": 0,
                    "pageSize": 50
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/list-item": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Numara bazlı rapor (anahtarla)",
        "operationId": "key_detail",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Bir paketteki her numaranın teslim durumu. pkgID ya da customID zorunlu.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "pkgID": {
                    "type": "integer"
                  },
                  "customID": {
                    "type": "string"
                  },
                  "target": {
                    "type": "string"
                  },
                  "operator": {
                    "type": "integer"
                  },
                  "state": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "pkgID ile": {
                  "value": {
                    "pkgID": 48213402,
                    "pageIndex": 0,
                    "pageSize": 100
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/summary": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Özet istatistik (anahtarla)",
        "operationId": "key_summary",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Tarih aralığındaki toplamlar.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "startDate",
                  "finishDate"
                ],
                "properties": {
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  }
                }
              },
              "examples": {
                "Kasım": {
                  "value": {
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-30 23:59"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/inquiry-number": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Numara sorgulama (anahtarla)",
        "operationId": "key_inquiry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Bir numaraya geçmişte gönderilen mesajlar.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "gsm"
                ],
                "properties": {
                  "gsm": {
                    "type": "string"
                  },
                  "sender": {
                    "type": "string"
                  },
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  }
                }
              },
              "examples": {
                "Numara": {
                  "value": {
                    "gsm": "905321234567",
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59"
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/credit": {
      "get": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Bakiye (anahtarla)",
        "operationId": "key_credit",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Kalan kredi. SMS göndermez — bağlantı testi için idealdir.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/list-sender": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Gönderen başlıkları (anahtarla)",
        "operationId": "key_senders",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Tanımlı başlıklar ve onay durumları (status 1 = onaylı).\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string"
                  },
                  "status": {
                    "type": "integer"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "İlk sayfa": {
                  "value": {
                    "pageIndex": 0,
                    "pageSize": 10
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/list-gateway": {
      "get": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Ağ geçitleri (anahtarla)",
        "operationId": "key_gateways",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Hesaba tanımlı ağ geçitleri.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        }
      }
    },
    "/v1/sms/mo/list-request": {
      "post": {
        "tags": [
          "VOIS anahtarı"
        ],
        "summary": "Gelen SMS (MO) (anahtarla)",
        "operationId": "key_mo",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "description": "Kısa numaranıza gelen mesajlar.\n\nYetki: sms:read. Gövde ve yanıt kullanıcı adı/şifre yöntemiyle aynıdır.\n\nDoküman: https://docs.vois.com.tr/sms/#vois-anahtari",
        "responses": {
          "200": {
            "description": "SMS servisinin yanıtı (`data` / `err`).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "502": {
            "description": "ERR_SERVICE_UNAVAILABLE: SMS servisine ulaşılamıyor.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "nullable": true
                    },
                    "err": {
                      "$ref": "#/components/schemas/SmsError"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "403": {
            "description": "insufficient_scope / sms_not_configured / sms_blocked",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "413": {
            "description": "payload_too_large (gövde 10 MB üstü)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "422": {
            "description": "invalid_request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          },
          "429": {
            "description": "rate_limited (anahtar başına 600/dk, hesap başına 1200/dk)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoisError"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "keyword": {
                    "type": "string"
                  },
                  "startDate": {
                    "type": "string",
                    "example": "2026-11-01 00:00"
                  },
                  "finishDate": {
                    "type": "string",
                    "example": "2026-11-10 23:59"
                  },
                  "pageIndex": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "0'dan başlar."
                  },
                  "pageSize": {
                    "type": "integer"
                  }
                }
              },
              "examples": {
                "RET": {
                  "value": {
                    "keyword": "RET",
                    "startDate": "2026-11-01 00:00",
                    "finishDate": "2026-11-10 23:59",
                    "pageIndex": 0,
                    "pageSize": 100
                  }
                }
              }
            }
          }
        }
      }
    },
    "/direct/": {
      "get": {
        "tags": [
          "Gönderim"
        ],
        "summary": "GET ile gönderim",
        "operationId": "direct",
        "security": [],
        "description": "Eski sistemler için tek satırlık gönderim; kimlik bilgileri adreste. Düz metin döner. ⚠️ Gerçek gönderim yapar ve kredi harcar.\n\nDoküman: https://docs.vois.com.tr/sms/#direct",
        "parameters": [
          {
            "name": "cmd",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Her zaman sendsms."
          },
          {
            "name": "kullanici",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "API kullanıcı adı."
          },
          {
            "name": "sifre",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "API şifresi."
          },
          {
            "name": "mesaj",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Mesaj metni (URL kodlamalı)."
          },
          {
            "name": "gsm",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Alıcı numarası."
          },
          {
            "name": "baslik",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Gönderen başlığı."
          },
          {
            "name": "nlss",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "0 Standart, 1 Türkçe, 2 Unicode."
          },
          {
            "name": "ahs",
            "in": "query",
            "required": true,
            "schema": {
              "type": "integer"
            },
            "description": "0 Bilgilendirme, 1 Ticari."
          }
        ],
        "responses": {
          "200": {
            "description": "Düz metin yanıt.",
            "content": {
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "basicAuth": {
        "type": "http",
        "scheme": "basic"
      },
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    },
    "schemas": {
      "SmsError": {
        "type": "object",
        "nullable": true,
        "properties": {
          "status": {
            "type": "integer",
            "description": "Hatanın sayısal sınıfı (her zaman HTTP koduyla aynı değildir)."
          },
          "code": {
            "type": "string",
            "example": "ERR_USER_CREDIT_REQUIRED",
            "description": "Hatayı bu alana göre ayırt edin."
          },
          "message": {
            "type": "string"
          }
        }
      },
      "VoisError": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string",
            "example": "insufficient_scope"
          },
          "message": {
            "type": "string"
          }
        }
      }
    }
  }
}
