Integrálja a Telesto-t saját belső megoldásaival vagy harmadik féltől származó szolgáltatásokkal RESTful API-nk használatával. 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: YOUR_API_KEY

Alap URL

https://telesto.app/v2

Sebességkorlátok

  • 100 kérés óránként IP címenként
  • 15 perces időkorlát ha túllépi a sebességkorlátot
  • Minden kérésnek tartalmaznia kell az API kulcsot 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 kerül visszaküldésre. Az üres vagy null mezők üres karakterláncként kerülnek visszaküldésre a konzisztencia érdekében.

Sikeres Válasz

{
    "id": "abc123...",
    "name": "My Product",
    "created": "2024-01-15 10:30:00"
}

Hiba Válasz

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Invalid API key"
    }
}

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 Az 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: YOUR_API_KEY"

Válasz

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

Legjobb Gyakorlatok

  • Tárolja API kulcsát biztonságosan (soha ne kliens oldali kódban)
  • Implementáljon újrapróbálkozási logikát 429 (sebességkorlát) válaszokra
  • Cache-elje a válaszokat amikor lehetséges az API hívások csökkentése érdekében
  • Használjon HTTPS-t minden kéréshez

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

Teljes Dokumentáció

Teljes API dokumentáció részletes paraméterekkel és példákkal elérhető itt:

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

Kezdő Lépések

  1. Győződjön meg róla, hogy Pro előfizetéssel rendelkezik
  2. Lépjen kapcsolatba a támogatással API hozzáférés kéréséhez és kulcsa 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.