Ping — fature.al API

Ping

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

Send a bearer token in the Authorization header.

Verify the token and return the single Wolt venue it is bound to. Call this first to confirm credentials and discover which company/branch/venue the token operates on.

Full URL: https://fature.al/api/partner/v1/wolt/ping

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.company	string
data.branch	string
data.venue_id	string
data.connection_status	string
data.server_time	string

403 The company has no Wolt add-on, the token has no Wolt right, or it resolves to no single active venue.

Field	Type	Description
status	boolean	Always false
message	string	Localised explanation, safe to log but not to branch on
code	string	Stable machine readable reason: `unauthenticated`, `wolt_not_enabled`, `forbidden`, `no_venue`, `order_not_found`, `invalid_transition`, `invalid_data`, `action_failed`, `wolt_upstream_error`, `idempotency_key_required`, `idempotency_in_progress`

429 Rate limit reached: 180 reads a minute per token. Retry after the number of seconds in the Retry-After header.

Field	Type	Description
message	string

Example request

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();

Example response

200

{
    "status": true,
    "data": {
        "company": "company",
        "branch": "branch",
        "venue_id": "venue id",
        "connection_status": "connection status",
        "server_time": "server time"
    }
}

403

{
    "status": true,
    "message": "Hello there",
    "code": "code"
}

429

{
    "message": "Hello there"
}

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