Integrálja a Telestot saját belső megoldásaival vagy harmadik fél szolgáltatásaival RESTful API-nk segítségével. Tökéletes egyedi integrációkhoz és automatizált munkafolyamatokhoz.

Előfeltételek: Pro előfizetés és érvényes API kulcs szükséges minden végponthoz.

Hitelesítés

Minden API kérés hitelesítést igényel az API kulcs használatával az Authorization fejlécben:

Authorization: AZ_ÖN_API_KULCSA

Alap URL

https://telesto.app/v2

Sebességkorlátok

  • 100 kérés óránként IP címenként
  • 15 perces időtúllépés ha túllépi a sebességkorlátot
  • Minden kérésben szerepelnie kell az API kulcsnak az Authorization fejlécben

A sebességkorlát túllépése átmeneti 15 perces blokkolást eredményez az IP címére.

Válasz Formátum

Minden válasz JSON formátumban érkezik. Az üres vagy null mezők üres karakterláncként kerülnek visszaadásra a konzisztencia érdekében.

Sikeres Válasz

{
    "id": "abc123...",
    "name": "Termék Nevem",
    "created": "2024-01-15 10:30:00"
}

Hiba Válasz

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Érvénytelen API kulcs"
    }
}

Hibakódok

Kód Típus Leírás
401 UNAUTHORIZED Hiányzó vagy érvénytelen API kulcs
403 FORBIDDEN Pro előfizetés szükséges
404 NOT_FOUND Erőforrás nem található
429 TOO_MANY_REQUESTS Sebességkorlát túllépve (várjon 15 percet)
500 SERVER_ERROR Belső hiba, próbálja újra később

Gyors Példa

Kérés

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: AZ_ÖN_API_KULCSA"

Válasz

[
    {
        "id": "a1b2c3...",
        "name": "Widget",
        "ean_upc": "123456789",
        "stock_onhand": "50",
        "created": "2024-01-15 10:30:00"
    }
]

Legjobb Gyakorlatok

  • Tárolja biztonságosan az API kulcsot (soha ne kliens oldali kódban)
  • Implementáljon újrapróbálkozási logikát 429 (sebességkorlát) válaszokra
  • Használjon gyorsítótárazást amikor lehetséges az API hívások csökkentéséhez
  • Használjon HTTPS-t minden kéréshez

Tipp: Tesztelje az integrációját kis adagokban először, hogy biztosan a sebességkorlátokon belül maradjon.

Teljes Dokumentáció

Részletes paraméterekkel és példákkal ellátott teljes API dokumentáció elérhető itt:

https://documenter.getpostman.com/view/3493/2s93Y2R1a8

Kezdő Lépések

  1. Győződjön meg róla, hogy rendelkezik Pro előfizetéssel
  2. Lépjen kapcsolatba a támogatással API hozzáférés igényléséhez és kulcs megszerzéséhez
  3. Tekintse át a dokumentációt az elérhető végpontokért

Jelenleg Béta verzióban: Aktívan bővítjük az API végpontokat és funkcionalitást. Ha érdekli az API használata vagy specifikus végpontokra van szüksége, kérjük lépjen kapcsolatba támogatási csapatunkkal.