Integrer Telesto med dine egne interne løsninger eller tredjepartstjenester ved å bruke vår RESTful API. Perfekt for tilpassede integrasjoner og automatiserte arbeidsflyter.

Forutsetninger: Pro-abonnement og gyldig API-nøkkel kreves for alle endepunkter.

Autentisering

Alle API-forespørsler krever autentisering ved å bruke din API-nøkkel i Authorization-header:

Authorization: DIN_API_NØKKEL

Base URL

https://telesto.app/v2

Hastighetsgrenser

  • 100 forespørsler per time per IP-adresse
  • 15-minutters timeout hvis hastighetsgrensen overskrides
  • Alle forespørsler må inkludere API-nøkkel i Authorization-header

Overskridelse av hastighetsgrensen vil resultere i en midlertidig 15-minutters blokkering for din IP-adresse.

Responsformat

Alle responser returneres i JSON-format. Tomme eller null-felter returneres som tomme strenger for konsistens.

Vellykket Respons

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

Feilrespons

{
    "statusCode": 401,
    "error": {
        "type": "UNAUTHORIZED",
        "description": "Ugyldig API-nøkkel"
    }
}

Feilkoder

Kode Type Beskrivelse
401 UNAUTHORIZED Manglende eller ugyldig API-nøkkel
403 FORBIDDEN Pro-abonnement kreves
404 NOT_FOUND Ressurs ikke funnet
429 TOO_MANY_REQUESTS Hastighetsgrense overskredet (vent 15 min)
500 SERVER_ERROR Intern feil, prøv igjen senere

Raskt Eksempel

Forespørsel

curl -X GET "https://telesto.app/v2/products" 
  -H "Authorization: DIN_API_NØKKEL"

Respons

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

Beste Praksis

  • Lagre API-nøkkelen din sikkert (aldri i klientside-kode)
  • Implementer retry-logikk for 429 (hastighetsgrense) responser
  • Cache responser når mulig for å redusere API-kall
  • Bruk HTTPS for alle forespørsler

Tips: Test integrasjonen din i små grupper først for å sikre at du holder deg innenfor hastighetsgrensene.

Full Dokumentasjon

Fullstendig API-dokumentasjon med detaljerte parametere og eksempler er tilgjengelig på:

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

Kom i Gang

  1. Sørg for at du har et Pro-abonnement
  2. Kontakt support for å be om API-tilgang og få din nøkkel
  3. Gjennomgå dokumentasjonen for tilgjengelige endepunkter

For øyeblikket i Beta: Vi utvider aktivt API-endepunkter og funksjonalitet. Hvis du er interessert i å bruke API-et eller trenger spesifikke endepunkter, vennligst kontakt vårt supportteam.