Kontrollo lidhjen: fature.al API

Kontrollo lidhjen

GET /api/partner/v1/wolt/ping Requires authentication Rate limited by the `api-global` limiter

Send a bearer token, plus the X-Client-Id and X-Client-Secret headers in the Authorization header.

Verifikon token-in dhe kthen njësinë (venue) e vetme Wolt me të cilën është lidhur. Thirreni të parën, që të konfirmoni kredencialet dhe të shihni mbi cilën kompani, njësi biznesi dhe njësi Wolt punon token-i.

URL-ja e plotë: https://fature.al/api/partner/v1/wolt/ping

Përgjigjet

200 Njësia (venue) mbi të cilën punon token-i: kompania, njësia e biznesit, id-ja e njësisë te Wolt, statusi i lidhjes dhe ora e serverit.

Field	Tipi	Përshkrimi
status	boolean
data	object
data.company	string	Emri i kompanisë në fature.al së cilës i takon lidhja Wolt
data.branch	string	Emri i njësisë së biznesit (degës) me të cilën është lidhur njësia Wolt
data.venue_id	string	Id-ja e njësisë (venue) te Wolt, ajo me të cilën është regjistruar lidhja
data.connection_status	string	Statusi i lidhjes Wolt në fature.al: `active`, `paused` ose `disconnected`. Në një përgjigje 200 është gjithmonë `active`, sepse token-i zgjidhet vetëm në një lidhje aktive; një lidhje e pezulluar ose e shkëputur kthen 403 me kodin `no_venue`
data.server_time	string	Ora e serverit në çastin e përgjigjes, ISO-8601 me offset-in e orës lokale. Krahasojeni me orën tuaj kur lexoni `received_at`, `pickup_at` dhe `occurred_at`, që vijnë në të njëjtin format

401 Unauthenticated

Field	Tipi	Përshkrimi
message	string

403 Kompania nuk e ka modulin Wolt, përdoruesi i token-it nuk ka të drejtën Wolt, ose token-i nuk zgjidhet në një njësi të vetme aktive.

Field	Tipi	Përshkrimi
status	boolean	Gjithmonë `false`
message	string	Shpjegim i përkthyer; ruajeni në log, por mos vendosni sipas tij
code	string	Arsyeja e qëndrueshme, e lexueshme nga makina: `unauthenticated` (token-i mungon ose nuk vlen), `wolt_not_enabled` (kompania nuk e ka modulin Wolt), `forbidden` (përdoruesi i token-it nuk ka të drejtën Wolt), `no_venue` (token-i nuk zgjidhet në një njësi të vetme aktive), `order_not_found` (nuk ka porosi të tillë për këtë njësi), `invalid_transition` (veprimi nuk lejohet për statusin aktual të porosisë), `invalid_data` (body i kërkesës nuk kaloi validimin), `action_failed` (veprimi dështoi nga ana jonë), `wolt_upstream_error` (Wolt e refuzoi veprimin ose nuk u përgjigj), `idempotency_key_required` (header-i `Idempotency-Key` mungon), `idempotency_in_progress` (një thirrje me të njëjtin çelës është ende në proces)

429 Kufiri i kërkesave u arrit: 180 lexime në minutë për token. Riprovoni pas numrit të sekondave në header-in Retry-After.

Field	Tipi	Përshkrimi
message	string

Shembull kërkese

cURL

curl -X GET 'https://fature.al/api/partner/v1/wolt/ping' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'

PHP (Laravel)

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'Authorization' => 'Bearer YOUR_TOKEN',
    'X-Client-Id' => 'YOUR_CLIENT_ID',
    'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
    'Accept' => 'application/json',
])->get('https://fature.al/api/partner/v1/wolt/ping');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/partner/v1/wolt/ping', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_TOKEN',
        'X-Client-Id' => 'YOUR_CLIENT_ID',
        'X-Client-Secret' => 'YOUR_CLIENT_SECRET',
        'Accept' => 'application/json',
    ],
]);

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

JavaScript

const response = await fetch('https://fature.al/api/partner/v1/wolt/ping', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
    'X-Client-Id': 'YOUR_CLIENT_ID',
    'X-Client-Secret': 'YOUR_CLIENT_SECRET',
    'Accept': 'application/json'
  }
});

const data = await response.json();

Shembull përgjigjeje

200

{
    "status": true,
    "data": {
        "company": "Pizzeria Era shpk",
        "branch": "Blloku",
        "venue_id": "5f3a1b2c4d5e6f7a8b9c0d1e",
        "connection_status": "active",
        "server_time": "2026-09-14T12:24:10+02:00"
    }
}

401

{
    "message": "Unauthenticated."
}

403

{
    "status": false,
    "message": "Porosia nuk u gjet.",
    "code": "order_not_found"
}

429

{
    "message": "Hello there"
}

This page as Markdown, or the whole API as OpenAPI.