Inex API Documentation

მულტი ფაილის ატვირთვა

მიმდინარე სერვისით თქვენ შეძლებთ ატვირთოთ ერთი ან რამდენიმე ფაილი სისტემაში. დაბრუნებული ფაილის ID-ები (UUID) შეგიძლიათ გამოიყენოთ ამანათის დეკლარირებისას.

POST /integrators/files/upload-multiple

Field	Type	In	Required	Example	Description
files[]	array (binary)	BODY (FormData)	Yes	binary data	ასატვირთი ფაილები (მინ: 1, მაქს: 10). დასაშვები ფორმატები: xlsx, pdf, jpeg, png, jpg, doc, docx, xls. მაქსიმალური ზომა: 10MB.

პასუხის სტრუქტურა 201 Created

Attribute	Type	Example	Description
data	array	[]	ატვირთული ფაილების მასივი.
data.*.uid	string (uuid)	98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p	ფაილის უნიკალური იდენტიფიკატორი.
data.*.name	string	98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p.pdf	ფაილის სისტემური სახელი.
data.*.originalName	string	invoice.pdf	ფაილის ორიგინალი სახელი.
data.*.extension	string	pdf	ფაილის გაფართოება.
data.*.size	integer	1024	ფაილის ზომა ბაიტებში.
data.*.mime	string	application/pdf	ფაილის MIME ტიპი.

შესაძლო პასუხები

Code	Description
201 Created	ფაილები წარმატებით აიტვირთა.
422 Unprocessable Entity	ვალიდაციის შეცდომა (არასწორი ფორმატი, ზომა ან რაოდენობა).
403 Forbidden	თქვენ არ გაქვთ ამ ოპერაციის შესრულების უფლება.
413 Payload Too Large	ფაილების ჯამური ზომა აღემატება დასაშვებ ლიმიტს.

cURL Request BASH

curl -X POST https://api-staging.inex.ge/api/v1/integrators/files/upload-multiple \
                -H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: multipart/form-data" \
-F "files[]=@/path/to/invoice.pdf" \
-F "files[]=@/path/to/image.jpg"

Response (201 Created)

JSON Response JSON

{
    "data": [
        {
            "uid": "98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p",
            "name": "98a76c5d-4e3f-2g1h-0i9j-8k7l6m5n4o3p.pdf",
            "originalName": "invoice.pdf",
            "mime": "application\/pdf",
            "size": 102456,
            "extension": "pdf"
        },
        {
            "uid": "12b34c5d-6e7f-8g9h-0i1j-2k3l4m5n6o7p",
            "name": "12b34c5d-6e7f-8g9h-0i1j-2k3l4m5n6o7p.jpg",
            "originalName": "image.jpg",
            "mime": "image\/jpeg",
            "size": 204800,
            "extension": "jpg"
        }
    ]
}

Error Response (422)

JSON Response JSON

{
    "message": "The files.0 must be a file of type: xlsx, pdf, jpeg, png, jpg, doc, docx, xls.",
    "errors": {
        "files.0": [
            "The files.0 must be a file of type: xlsx, pdf, jpeg, png, jpg, doc, docx, xls."
        ]
    }
}