Datakilder og API

Slik sender du poster til en datakilde med Sendtric-API-et

Sist oppdatert

Med en API-datakilde sender ditt eget system JSON-poster til Sendtric hver gang dataene dine endres. Sendtric lagrer dem som hostede data, og bildene dine henter opp hver enkelt abonnents post når en e-post åpnes.

Denne veiledningen er ment for den som skriver koden som sender dataene. Hvis du heller vil at Sendtric skal hente data fra API-et ditt hver gang siden åpnes, se hvordan du kobler en datakilde til din egen API.

Opprett datakilden

  1. I venstre sidefelt klikker du på Datakilder, og deretter Ny datakilde.
  2. Under APIvelger du API og klikk på Fortsett.
  3. Velg Send data til Sendtric og klikk på Fortsett.
  4. Fyll ut:
    • Navn på datakilde: for eksempel «Lojalitetsmedlemmer».
    • Felt for unik identifikator: JSON-feltet som identifiserer hver enkelt post, for eksempel customer_id eller email. Hver post du sender må inneholde dette.
    • Beskrivelse (valgfritt).
  5. Klikk Lagre datakilde. Datakilden opprettes, og API viser dine endepunkter og API-nøkkel.
  6. Kopier det du trenger, og klikk deretter Fortsett for å fullføre.
API-delen for en ny datakilde, som viser endepunktene for oppretting/oppdatering av enkeltposter og masseoppretting/oppdatering, API-nøkkelen og eksempler på forespørsler

Du kan når som helst finne endepunktene igjen i datakildens API-detaljer .

Autentiser

Send nøkkelen din i Authorization overskriften på hver forespørsel:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Den API-nøkkelen for datakilden fungerer kun for sending av datakildeoppføringer, så den kan trygt gis til en utvikler eller et automatiseringsverktøy. Hvis du har et API-abonnement, fungerer din eksisterende API-nøkkel også på disse endepunktene.

Hold nøkkelen din utenfor frontend-koden og offentlige repositorier. Hvis den noen gang blir eksponert, må du generere den på nytt under Innstillinger → API-nøkler → API-nøkkel for datakilde, og oppdater deretter alt som bruker den.

Opprett eller oppdater poster

Send et enkelt JSON-objekt eller en matrise med objekter til endepunktet som vises i Sendtric. Én post:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "customer_id": "CUST_1001",
  "first_name": "Sarah",
  "points": 1250
}

Flere poster i én forespørsel:

POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

[
  { "customer_id": "CUST_1001", "first_name": "Sarah", "points": 1250 },
  { "customer_id": "CUST_1002", "first_name": "James", "points": 300 }
]

Slik lagres oppføringene:

  • Hvis det ennå ikke finnes noen post med den identifikatoren, opprettes det en ny.
  • Hvis man gjør det, er det erstattes med det du har sendt. Felter du utelater, blir fjernet, så send alltid hele posten.
  • Nye og oppdaterte oppføringer er vanligvis tilgjengelige i løpet av omtrent ett minutt.
  • Identifikatorer sammenlignes uten å skille mellom store og små bokstaver.

En vellykket forespørsel returnerer 200 med et kort sammendrag, for eksempel {"status":"ok","records":2}.

Du kan plassere objekter inne i en post, for eksempel "address": { "city": "Leeds" }, og velge nestede felt i bildeditoren.

Slett poster

Slett én post ved å legge til identifikatoren til slutten av endepunktet:

DELETE <your data source endpoint>/cust_1001
Authorization: Bearer YOUR_API_KEY

Slett flere ved å sende en matrise med identifikatorer:

DELETE <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

["cust_1001", "cust_1002"]

Grenser

GrenseVerdi
Antall poster per forespørsel10 000
Forespørselsstørrelse10 MB
Identifikatorverdi255 tegn
En hvilken som helst enkelt tekstverdi10 KB
Innstikkdybde20 nivåer

Send poster i batcher i stedet for én forespørsel per post. For tusenvis av poster, se hvordan du sender store datamengder til en datakilde.

Svar og feilmeldinger

StatusHva det betyrHva skal man gjøre?
200Godkjente oppføringerIngenting. Hvis noen poster ble hoppet over, angir overskriften «X-Skipped-Records» hvor mange
400Dataene er ikke gyldig JSONKontroller forespørselens innhold
401Manglende eller feil API-nøkkelSjekk «Authorization»-overskriften
404Datakilden ble ikke funnet for denne nøkkelenKontroller endepunktet og at nøkkelen tilhører den samme kontoen
413For mange poster eller for storDel forespørselen opp i mindre deler
422Det var ikke mulig å lagre oppføringenMeldingen viser hvilke poster som mangler identifikatorfeltet eller som er for store
503Sendtric er opptattVent i det antall sekunder som er angitt i «Retry-After»-overskriften, og send deretter den samme forespørselen på nytt

Når bare noen av postene i en forespørsel er ugyldige, lagres de gyldige likevel, mens resten hoppes over.

Sjekk opplysningene dine

Åpne datakilden og gå til Records . Søk etter identifikatorverdi og klikk på en post for å se hele JSON-dataene som er lagret i Sendtric.

Neste trinn

Var denne artikkelen nyttig?

Klikk på bildet for å zoome inn. Dra eller rull for å se deg rundt.