Detajet e produktit sipas ID (v1)

Detajet e produktit sipas ID

GET /api/v1/products/{id}/details Requires authentication Rate limited by the `api-global` limiter v1

Send a bearer token in the Authorization header.

Merrni detajet e nje produkti sipas id-se per kompanine tuaj.

Kthen me shume se lista: pervec emrit dhe cmimit, edhe kodin fiskal te njesise, normen e TVSH-se dhe kategorine.

Full URL: https://fature.al/api/v1/products/{id}/details

Path parameters

Name	Type	Required	Description
id	integer	yes	ID e produktit.

Responses

200 OK

Field	Type	Description
status	boolean
data	object
data.product	object
data.product.service	boolean	True for a service, false for an article that is tracked in stock
data.product.category	object, nullable	The category resolved, or null when the product has none
data.product.category.id	integer
data.product.category.name	string
data.product.category.color	string, nullable	Hex colour used by the POS grid
data.product.created_at	string, nullable	Creation timestamp, ISO 8601

404 Produkti nuk u gjet, ose nuk i perket kompanise suaj.

Field	Type	Description
status	boolean	Always false. A successful response carries `status: true` and a `data` object instead
message	string	The exception message. Empty when the failure carries no exception of its own
errors	array	Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message`

500 Gabim i papritur ne server.

Field	Type	Description
status	boolean	Always false. A successful response carries `status: true` and a `data` object instead
message	string	The exception message. Empty when the failure carries no exception of its own
errors	array	Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message`

Example request

cURL

curl -X GET 'https://fature.al/api/v1/products/42/details' \
  -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/v1/products/42/details');

$data = $response->json();

PHP (Guzzle)

use GuzzleHttp\Client;

$client = new Client();

$response = $client->request('GET', 'https://fature.al/api/v1/products/42/details', [
    '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/v1/products/42/details', {
  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": {
        "product": {
            "service": true,
            "category": {
                "id": 1,
                "name": "Jane Doe",
                "color": "color"
            },
            "created_at": "created at"
        }
    }
}

404

{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}

500

{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}

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