Integrer Telesto med dine egne interne løsninger eller tredjepartstjenester ved hjelp av vårt 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 hjelp av din API-nøkkel i Authorization-headeren:

Authorization: DIN_API_NØKKEL

Basis URL

https://telesto.app/v2

Hastighetsbegrensninger

  • 100 forespørsler per time per IP-adresse
  • 15 minutters timeout hvis hastighetsbegrensningen overstiges
  • Alle forespørsler må inkludere API-nøkkel i Authorization-headeren

Å overskride hastighetsbegrensningen 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.

Suksessrespons

{
    "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 Hastighetsbegrensning overskredet (vent 15 min)
500 SERVER_ERROR Intern feil, prøv igjen senere

Hurtig 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 (hastighetsbegrensning) responser
  • Cache responser når mulig for å redusere API-kall
  • Bruk HTTPS for alle forespørsler

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

Fullstendig Dokumentasjon

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

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

Komme 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. Se gjennom dokumentasjonen for tilgjengelige endepunkter

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