Δημιουργία συνδρομής σε webhook

POST/api/crm/v2/webhooks_subscriptions.addv2

operationId: webhooksSubscriptions.add

Εξουσιοδότηση

api-token + language + role

Παράμετροι ερωτήματος

branch_idintegerυποχρεωτικό

Παράδειγμα: 8412

Σώμα αιτήματος `application/json`

object

webhook_event_idintegerυποχρεωτικό

Παράδειγμα: 4

urlstringυποχρεωτικό

Παράδειγμα: https://partner.example.com/hooks/foodsoul

descriptionstringυποχρεωτικό

Παράδειγμα: Учётная система

Απαντήσεις

object

statusstringυποχρεωτικό

Τιμές:successerror

Παράδειγμα: success

dataobject

rowobject

settingsobject (WebhooksBranchSettings)

secretstringμπορεί να είναι null

null, μέχρι το δίκτυο να δημιουργήσει το secret

Παράδειγμα: 9f2c…

enabledbooleanυποχρεωτικό

Παράδειγμα: true

listarray of object

idintegerυποχρεωτικό

Παράδειγμα: 12

date_creationstring (DataTimeFormatSQL) υποχρεωτικό

Παράδειγμα: 2024-05-02 08:31:16

webhook_event_idintegerυποχρεωτικό

Παράδειγμα: 4

slugstringυποχρεωτικό

Ο κωδικός συμβάντος που αποστέλλεται στο σώμα του webhook

Παράδειγμα: order.created

translation_keystringυποχρεωτικό

Κλειδί μετάφρασης ονόματος συμβάντος

Παράδειγμα: webhooksSubscriptionsEvent.orderCreated

urlstringυποχρεωτικό

Παράδειγμα: https://partner.example.com/hooks/foodsoul

descriptionstringυποχρεωτικό

Παράδειγμα: Учётная система

enabledbooleanυποχρεωτικό

Παράδειγμα: true

blockedbooleanυποχρεωτικό

Η συνδρομή απενεργοποιείται αυτόματα μετά από μια σειρά σφαλμάτων

Παράδειγμα: false

count_errorsintegerυποχρεωτικό

Αριθμός διαδοχικών αποτυχημένων αποστολών

Παράδειγμα: 0

curl -X POST 'https://foodsoul.pro/api/crm/v2/webhooks_subscriptions.add?branch_id=8412' \
  -H 'Authorization: Bearer fs_api_YOUR_TOKEN' \
  -H 'language: el' \
  -H 'role: partner' \
  -H 'Content-Type: application/json' \
  -d '{"webhook_event_id":4,"url":"https://partner.example.com/hooks/foodsoul","description":"Учётная система"}'

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://foodsoul.pro/api/crm/v2/webhooks_subscriptions.add?branch_id=8412', [
    'headers' => [
        'Authorization' => 'Bearer fs_api_YOUR_TOKEN',
        'language' => 'el',
        'role' => 'partner',
    ],
    'json' => [
        'webhook_event_id' => 4,
        'url' => 'https://partner.example.com/hooks/foodsoul',
        'description' => 'Учётная система',
    ],
]);

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

const response = await fetch("https://foodsoul.pro/api/crm/v2/webhooks_subscriptions.add?branch_id=8412", {
    method: "POST",
    headers: {
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "el",
        "role": "partner",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        "webhook_event_id": 4,
        "url": "https://partner.example.com/hooks/foodsoul",
        "description": "Учётная система"
    }),
})
const data = await response.json()

import requests

response = requests.request(
    "POST",
    "https://foodsoul.pro/api/crm/v2/webhooks_subscriptions.add?branch_id=8412",
    headers={
        "Authorization": "Bearer fs_api_YOUR_TOKEN",
        "language": "el",
        "role": "partner",
    },
    json={
        "webhook_event_id": 4,
        "url": "https://partner.example.com/hooks/foodsoul",
        "description": "Учётная система",
    },
)
data = response.json()

Απάντηση 200

{
  "status": "success",
  "data": {
    "row": {
      "settings": {
        "secret": "9f2c…",
        "enabled": true
      },
      "list": [
        {
          "id": 12,
          "date_creation": "2024-05-02 08:31:16",
          "webhook_event_id": 4,
          "slug": "order.created",
          "translation_key": "webhooksSubscriptionsEvent.orderCreated",
          "url": "https://partner.example.com/hooks/foodsoul",
          "description": "Учётная система",
          "enabled": true,
          "blocked": false,
          "count_errors": 0
        }
      ]
    }
  }
}

Τα αιτήματα αποστέλλονται στο foodsoul.pro — αυτός είναι ο κεντρικός υπολογιστής αυτής της πύλης, δεν μπορείτε να επιλέξετε άλλον.

Δημιουργία συνδρομής σε webhook

Εξουσιοδότηση

Παράμετροι ερωτήματος

Σώμα αιτήματος application/json

Απαντήσεις

Σώμα αιτήματος `application/json`