API დოკუმენტაცია

ჩააშენე Ephoto შენს მაღაზიაში / აპლიკაციაში: ატვირთე ფოტო API-ით, მიიღე თეთრფონიანი დამუშავებული სურათი და ჩასვი შენს საიტზე ლინკით ან embed-ით.

1. ავტენტიფიკაცია

შექმენი API key API Keys გვერდზე და გადააწოდე ყოველ მოთხოვნას X-Api-Key header-ით.

curl https://ephoto.ge/api/v1/images \
  -H "X-Api-Key: ephk_live_xxxxxxxx"

2. Base URL

https://ephoto.ge/api/v1

3. Endpoints

POST/images— ფოტოს ატვირთვა + ფონის მოშორება
GET/images/:id— დამუშავების სტატუსი + variants
GET/images— ფოტოების სია
POST/products— პროდუქტის შექმნა
GET/products— პროდუქტების სია
POST/categories— კატეგორია / ქვეკატეგორია
GET/categories— კატეგორიების ხე

4. ფოტოს დამუშავება

multipart upload. branding ჩართვისას — 2 credit, სხვა შემთხვევაში 1.

curl -X POST https://ephoto.ge/api/v1/images \
  -H "X-Api-Key: ephk_live_xxxx" \
  -F "file=@product.jpg" \
  -F "brand=true" \
  -F "brand_style=bottom-bar"

# → 201
{
  "id": "uuid",
  "status": "ready",
  "branded": true,
  "variants": [
    { "variant": "full",  "url": "https://s3.iserv.ge/ephoto/.../full.png" },
    { "variant": "1024",  "url": "..." },
    { "variant": "thumb", "url": "..." }
  ]
}

5. Webhooks

დაარეგისტრირე endpoint და მიიღე შეტყობინება დამუშავების დასრულებისას (product.image.ready), HMAC-ხელმოწერით.

POST https://your-site.ge/webhook
X-Ephoto-Signature: sha256=...
{ "event": "product.image.ready", "data": { "image_id": "uuid", "variants": [...] } }

6. Embed — საიტზე ჩასმა

ყველა დამუშავებულ ფოტოს აქვს პირდაპირი ლინკი და embed კოდი:

<!-- პირდაპირი <img> -->
<img src="https://ephoto.ge/uploads/.../full.png" alt="product" />

<!-- iframe viewer -->
<iframe src="https://ephoto.ge/embed/IMAGE_ID" width="400" height="400" frameborder="0"></iframe>

ლინკსა და embed კოდს იღებ ფოტოების გვერდზე თითო სურათზე.

7. Rate limiting

თითო API key — 60 req/min (default), Business გეგმაზე მეტი. პასუხის header-ები: X-RateLimit-Remaining.