> ## 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. # Ověřit zprávy bez odeslání > Ověří požadavek na odeslání, aniž by cokoli odeslal nebo účtoval. Přijímá stejné tělo jako odesílací endpointy JSON API v2 — jeden objekt `Message` (jako `POST /message`) nebo pole 1 až 10 objektů `Message` (jako `POST /messages`). Kontroluje se pouze struktura: pole a jejich typy, kroky flow a formát čísel příjemců. Doručitelnost, schválení odesílatele, opt-out seznamy ani kredit se nekontrolují. ## OpenAPI ````yaml /openapi/rest/restapi_v1.yaml post /messaging/validate openapi: 3.1.0 info: title: REST API SmsManager description: > REST API pro správu vašeho účtu SmsManager: API klíče, kredit, fakturace, kontaktní seznamy (blacklist / opt-out), zjišťování stavu zpráv, přijaté zprávy a podpora hromadného odesílání. ## Autentizace Pro všechny požadavky je vyžadován API klíč — zasílejte jej v HTTP hlavičce `x-api-key`. Svůj API klíč najdete v sekci [Vývojáři](https://app.smsmanager.com/app/developers/). Pro odesílání zpráv použijte [JSON API v2](https://api.smsmngr.com/v2). version: v1 contact: url: https://smsmanager.com email: cc@smsmanager.com servers: - url: https://rest-api.smsmngr.com/v1 description: Produkční server security: - x-api-key: [] tags: - name: api x-displayName: API klíče x-group: API klíče description: > Správa API klíčů: profil aktuálního klíče, vytváření a správa podřízených klíčů. - name: credit x-displayName: Kredit x-group: Kredit description: | Stav kreditu, ceník, objednatelné služby a upozornění na nízký kredit. - name: billing x-displayName: Fakturace x-group: Fakturace description: | Fakturační kontakt, faktury a dobití kreditu bankovním převodem. - name: status x-displayName: Stav zpráv x-group: Stav zpráv description: | Stav odeslaných zpráv a agregované statistiky odesílání. - name: inbox x-displayName: Přijaté zprávy x-group: Přijaté zprávy description: | Přijaté (příchozí) zprávy. - name: blacklist x-displayName: Blacklist a Opt-out x-group: Blacklist a Opt-out description: > Spravované kontaktní seznamy. Blacklist blokuje všechny zprávy na uvedená čísla; opt-out seznam blokuje zprávy s tagem `promotional`. - name: messaging x-displayName: Hromadné odesílání x-group: Hromadné odesílání description: > Podpůrné endpointy pro hromadné odesílání: URL pro nahrání hromadných souborů a rušení naplánovaných zpráv. - name: partner x-displayName: Zařízení a příjemci x-group: Zařízení a příjemci description: | Registrace push zařízení a příjemců zpráv. paths: /messaging/validate: post: tags: - messaging summary: Ověřit zprávy bez odeslání description: > Ověří požadavek na odeslání, aniž by cokoli odeslal nebo účtoval. Přijímá stejné tělo jako odesílací endpointy JSON API v2 — jeden objekt `Message` (jako `POST /message`) nebo pole 1 až 10 objektů `Message` (jako `POST /messages`). Kontroluje se pouze struktura: pole a jejich typy, kroky flow a formát čísel příjemců. Doručitelnost, schválení odesílatele, opt-out seznamy ani kredit se nekontrolují. requestBody: required: true content: application/json: schema: oneOf: - type: object description: Jedna zpráva ve formátu `Message` JSON API v2. - type: array minItems: 1 maxItems: 10 items: type: object description: Pole zpráv ve formátu `Message` JSON API v2. examples: Single message: value: to: - phone_number: '420777123456' body: Hello! Multiple messages: value: - to: - phone_number: '420777123456' - phone_number: '123' body: Hello! - to: - phone_number: '420777123457' flow: - sms: body: Hello via lowcost! gateway: lowcost responses: '200': description: >- Výsledek validace (vrací se i v případě neplatného obsahu požadavku — viz `success`). content: application/json: schema: type: object properties: success: type: boolean description: >- `true` jen tehdy, když validací prošly všechny zprávy a všichni příjemci (`rejected` i `errors` jsou prázdné). validate: type: object properties: accepted: type: array description: >- Položky, které prošly validací. Pro jednu zprávu `key` indexuje příjemce v `to` (jako `POST /message`); pro pole zpráv `key` indexuje odeslané pole (jako `POST /messages`). items: type: object properties: key: type: string description: >- Index příjemce (jedna zpráva) nebo zprávy v poli požadavku. phone_number: type: string description: >- Číslo příjemce tak, jak bylo odesláno (přítomno jen pro požadavek s jednou zprávou). rejected: type: array description: >- Položky, které validací neprošly, stejná sémantika `key` jako u `accepted`. Podrobnosti jsou v `errors`, propojitelné přes `key`. items: type: object properties: key: type: string phone_number: type: string description: >- Číslo příjemce tak, jak bylo odesláno (přítomno jen pro požadavek s jednou zprávou). errors: type: array description: >- Všechny chyby validace. Přítomno vždy (prázdné pole, když vše prošlo). items: type: object properties: key: type: string description: >- Klíč související položky v `rejected`. Vynechán u chyb na úrovni zprávy u požadavku s jednou zprávou. field: type: string description: >- Cesta k neplatnému poli (např. `flow[0].sms.gateway`, `to[1].phone_number`). message: type: string code: type: string description: >- Interní stavový kód, pokud existuje (`302` pro číslo ve špatném formátu). example: success: false validate: accepted: - key: '0' phone_number: '420777123456' rejected: - key: '1' phone_number: '123' errors: - key: '1' field: to[1].phone_number message: Phone number is not in a valid format code: '302' '400': description: Chybný požadavek content: application/json: schema: $ref: '#/components/schemas/Error' examples: Missing body: value: message: Missing request body Too many messages: value: message: Request must contain 1 to 10 messages '500': description: Interní chyba content: application/json: schema: $ref: '#/components/schemas/Error' example: message: Failed to validate message components: schemas: Error: type: object properties: message: type: string description: Chybová zpráva. securitySchemes: x-api-key: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.