Promo-Code hinzufügen

POST/api/crm/v2/special_offers_promo_codes.addv2

operationId: specialOffersPromoCodes.add

Fügt einen Promo-Code hinzu. In code können mehrere Promo-Codes durch Kommas getrennt übergeben werden.

Autorisierung

api-token + language + role

Abfrageparameter

branch_idinteger

Die Filiale, in der die Anfrage ausgeführt wird. Ein Partner mit mehreren Filialen muss diesen Parameter angeben, andernfalls wird die Anfrage mit einem Fehler abgelehnt. Bei einem Partner mit nur einer Filiale wird dieser Wert vom Server automatisch gesetzt.

Beispiel: 8778

special_offer_idintegererforderlich

Beispiel: 1

Anfragetext `application/json`

object

codestringerforderlich

Promo-Code; mehrere Promo-Codes können durch Kommas getrennt übergeben werden

Beispiel: CODE1940

countinteger

Beispiel: 2

date_availablestring (DataTimeFormat)

Beispiel: 17:45 06/05/2024

date_expirationstring (DataTimeFormat)

Beispiel: 17:45 06/05/2024

bonuses_sumnumber

Beispiel: 3.14

bonuses_validityinteger

Gültigkeitsdauer der Boni in Tagen; 0 — unbegrenzt

Beispiel: 3

Antworten

object (Response)

statusstringerforderlich

Werte:successerror

Beispiel: success

Eine der Optionen

object

Fehlerinformationen

errorobjecterforderlich

codeintegererforderlich

Fehlercode

variablesobject

descriptionstringerforderlich

Fehlerbeschreibung

object

Datenarray (Struktur abhängig von der Aktion, siehe Beispiele)

dataobjecterforderlich

curl -X POST 'https://foodsoul.ru/api/crm/v2/special_offers_promo_codes.add?special_offer_id=1' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: de' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"code":"CODE1940","count":2,"date_available":"17:45 06/05/2024","date_expiration":"17:45 06/05/2024","bonuses_sum":3.14,"bonuses_validity":3}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.ru/api/crm/v2/special_offers_promo_codes.add?special_offer_id=1', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'de',
        'role' => 'partner',
    ],
    'json' => [
        'code' => 'CODE1940',
        'count' => 2,
        'date_available' => '17:45 06/05/2024',
        'date_expiration' => '17:45 06/05/2024',
        'bonuses_sum' => 3.14,
        'bonuses_validity' => 3,
    ],
]);

$data = json_decode((string) $response->getBody(), true);

const response = await fetch("https://foodsoul.ru/api/crm/v2/special_offers_promo_codes.add?special_offer_id=1", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "de",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "code": "CODE1940",
        "count": 2,
        "date_available": "17:45 06/05/2024",
        "date_expiration": "17:45 06/05/2024",
        "bonuses_sum": 3.14,
        "bonuses_validity": 3
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.ru/api/crm/v2/special_offers_promo_codes.add?special_offer_id=1",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "de",
        "role": "partner",
    },
    json={
        "code": "CODE1940",
        "count": 2,
        "date_available": "17:45 06/05/2024",
        "date_expiration": "17:45 06/05/2024",
        "bonuses_sum": 3.14,
        "bonuses_validity": 3,
    },
)
data = response.json()

Antwort 200

{
  "error": {
    "code": 0,
    "variables": {},
    "description": "string"
  }
}

Anfragen werden an foodsoul.ru gesendet – dies ist der Host dieses Portals, ein anderer kann nicht ausgewählt werden.

Promo-Code hinzufügen

Autorisierung

Abfrageparameter

Anfragetext application/json

Antworten

Anfragetext `application/json`