> ## Documentation Index
> Fetch the complete documentation index at: https://smsmanager.cz/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Odeslání jednoduché zprávy (GET request)

> Zjednodušené odeslání jedné SMS pomocí query string parametrů. Pro plnou funkčnost (flow, více příjemců, doručovací okno, ...) použijte `/message`.




## OpenAPI

````yaml /openapi/json/jsonapi_v2.yaml get /simple/message
openapi: 3.1.0
info:
  title: JSON API
  description: >
    API pro odesílání zpráv přes SMS, Viber, WhatsApp, RCS a další komunikační
    kanály.


    ## JSON API v2


    API klíč je vyžadován pro všechny požadavky. Svůj API klíč najdete v
    [nastavení účtu](https://app.smsmanager.com/api-cloud).


    Starší verze API (http-api a xml-api) jsou zastaralé a místo nich byste měli
    používat toto JSON API v2.
  version: v2
  contact:
    url: https://smsmanager.cz
    email: cc@smsmanager.cz
servers:
  - url: https://api.smsmngr.com/v2
    description: Odpoví s daty vašeho požadavku
security: []
tags:
  - name: sending
    x-displayName: Odesílání
    description: >
      Pro odesílání zpráv použijte jeden z následujících endpointů.

      - `/message` pro odeslání zprávy až 10 příjemcům

      - `/message/priority` pro odeslání prioritní zprávy (zpracována prioritní
      frontou)

      - `/messages` pro odeslání více zpráv (až 10 zpráv najednou)

      - `/simple/message` pro odeslání jednoduché zprávy (GET a POST)
paths:
  /simple/message:
    get:
      tags:
        - sending
      summary: Odeslání jednoduché zprávy (GET request)
      description: >
        Zjednodušené odeslání jedné SMS pomocí query string parametrů. Pro plnou
        funkčnost (flow, více příjemců, doručovací okno, ...) použijte
        `/message`.
      parameters:
        - name: apikey
          in: query
          required: true
          schema:
            type: string
          description: Váš API klíč.
        - name: phone_number
          in: query
          required: true
          schema:
            type: string
          description: Telefonní číslo příjemce (akceptován je i alias `number`).
          example: '420777123456'
        - name: message
          in: query
          required: true
          schema:
            type: string
          description: Tělo zprávy (akceptován je i alias `body`).
        - name: sender
          in: query
          required: true
          schema:
            type: string
          description: >-
            Název odesílatele nebo virtuální číslo (může být vyžadována
            předchozí registrace).
        - name: gateway
          in: query
          required: false
          schema:
            type: string
            enum:
              - high
              - lowcost
              - direct
              - custom
              - simhost
              - gsm
            default: high
          description: SMS brána použitá pro odeslání.
        - name: datetime
          in: query
          required: false
          schema:
            type: string
            format: date-time
          description: >-
            Naplánovaný čas odeslání zprávy, v UTC (akceptován je i alias
            `time`).
          example: '2025-01-11T10:00:00Z'
        - name: customID
          in: query
          required: false
          schema:
            type: string
          description: >-
            Váš vlastní identifikátor zprávy. Je uložen v `payload` zprávy (jako
            `customID`) a vrácen v notifikacích o doručení.
      responses:
        '200':
          description: Jednoduchá zpráva byla úspěšně odeslána
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MessageSimpleResponse'
              examples:
                Accepted message:
                  value:
                    request_id: 66666666-6666-6666-6666-666666666666
                    message_id: pppppppp-qqqq-rrrr-ssss-tttttttttttt
                    accepted: true
                Rejected invalid sender:
                  value:
                    request_id: 77777777-7777-7777-7777-777777777777
                    accepted: false
                Rejected missing parameter:
                  value:
                    request_id: 88888888-8888-8888-8888-888888888888
                    accepted: false
                Accepted message with accents:
                  value:
                    request_id: 99999999-9999-9999-9999-999999999999
                    message_id: uuuuuuuu-vvvv-wwww-xxxx-yyyyyyyyyyyy
                    accepted: true
                Accepted high priority:
                  value:
                    request_id: aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
                    message_id: zzzzzzzz-zzzz-zzzz-zzzz-zzzzzzzzzzzz
                    accepted: true
        '400':
          description: Neplatný požadavek
      security:
        - apikey: []
components:
  schemas:
    MessageSimpleResponse:
      type: object
      properties:
        request_id:
          type: string
          description: Unikátní identifikátor požadavku.
          example: bc36f3d1-d284-463a-921b-a3560c154649
        message_id:
          type: string
          description: Unikátní identifikátor zprávy.
          example: bc36f3d1-d284-463a-921b-a3560c154649
        accepted:
          type: boolean
          description: True, pokud byla zpráva přijata, false, pokud byla odmítnuta.
          example: true
  securitySchemes:
    apikey:
      type: apiKey
      in: query
      name: apikey

````