Hoe stuur je records naar een gegevensbron met de Sendtric API?
Laatst bijgewerkt
Met een API-gegevensbron stuurt je eigen systeem JSON-records naar Sendtric zodra je gegevens veranderen. Sendtric slaat deze op als gehoste gegevens, en je afbeeldingen halen het record van elke abonnee op wanneer een e-mail wordt geopend.
Deze handleiding is bedoeld voor iedereen die de code schrijft waarmee de gegevens worden verzonden. Als je liever hebt dat Sendtric bij elke keer openen gegevens uit je API haalt, kijk dan bij hoe je een gegevensbron aan je eigen API koppelt.
Maak de gegevensbron aan
- Klik in de linkerzijbalk op Gegevensbronnenen vervolgens Nieuwe gegevensbron.
- Onder APIkies je API en klik op Doorgaan.
- Kies 'Gegevens naar Sendtric verzenden' en klik op Doorgaan.
- Vul het volgende in:
- Naam van de gegevensbron: bijvoorbeeld "Loyaliteitsleden".
- Veld voor unieke identificatiecode: het JSON-veld dat elk record identificeert, zoals
customer_idofemail. Elk record dat je verstuurt, moet dit veld bevatten. - Beschrijving (optioneel).
- Klik op Op 'Gegevensbron opslaan'. De gegevensbron wordt aangemaakt en de API -stap toont je eindpunten en API-sleutel.
- Kopieer wat je nodig hebt en klik dan op Doorgaan om af te ronden.

Je kunt de eindpunten op elk moment weer terugvinden in de tabblad 'API-details' van de gegevensbron.
Inloggen
Zet je sleutel in de Authorization header van elk verzoek:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/jsonDe API-sleutel voor gegevensbronnen werkt alleen voor het verzenden van gegevensbronrecords, dus je kunt deze gerust aan een ontwikkelaar of een automatiseringstool geven. Als je een API-abonnement hebt, werkt je bestaande API-sleutel ook op deze eindpunten.
Houd je sleutel uit de front-end-code en openbare repositories. Mocht hij ooit openbaar worden, genereer hem dan opnieuw via Instellingen → API-sleutels → API-sleutel voor gegevensbron, en werk vervolgens alles bij waar deze sleutel wordt gebruikt.
Records aanmaken of bijwerken
POST één JSON-object of een array met objecten naar het eindpunt dat in Sendtric wordt weergegeven. Eén record:
POST <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"customer_id": "CUST_1001",
"first_name": "Sarah",
"points": 1250
}Meerdere records in één verzoek:
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 }
]Hoe gegevens worden opgeslagen:
- Als er nog geen record met die identificatiecode bestaat, wordt er een nieuw record aangemaakt.
- Als je dat doet, is het wordt vervangen door wat je hebt gestuurd. Velden die je weglaat, worden verwijderd, dus stuur altijd het volledige record.
- Nieuwe en bijgewerkte gegevens zijn meestal binnen ongeveer een minuut beschikbaar.
- Bij het vergelijken van identificatiecodes wordt geen onderscheid gemaakt tussen hoofdletters en kleine letters.
Een succesvol verzoek levert 200 een korte samenvatting, bijvoorbeeld {"status":"ok","records":2}.
Je kunt objecten in een record nesten, bijvoorbeeld "address": { "city": "Leeds" }, en in de afbeeldingseditor de geneste velden selecteren.
Records verwijderen
Verwijder één record door de identificatiecode ervan aan het einde van het eindpunt toe te voegen:
DELETE <your data source endpoint>/cust_1001
Authorization: Bearer YOUR_API_KEYVerwijder er meerdere door een reeks ID’s te sturen:
DELETE <your data source endpoint>
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
["cust_1001", "cust_1002"]Beperkingen
| Limiet | Waarde |
|---|---|
| Aantal records per verzoek | 10.000 |
| Grootte van het verzoek | 10 MB |
| Waarde van de identificatiecode | 255 tekens |
| Elke willekeurige tekstwaarde | 10 KB |
| Nestdiepte | 20 levels |
Stuur records in batches in plaats van één verzoek per record. Voor duizenden records, zie hoe je grote hoeveelheden gegevens naar een gegevensbron kunt sturen.
Reacties en fouten
| Status | Wat dit betekent | Wat moet je doen? |
|---|---|---|
| 200 | Geaccepteerde records | Niets. Als er nummers zijn overgeslagen, staat in de X-Skipped-Records-header hoeveel |
| 400 | De inhoud is geen geldige JSON | Controleer de inhoud van het verzoek |
| 401 | Ontbrekende of verkeerde API-sleutel | Controleer de Authorization-header |
| 404 | De gegevensbron voor deze sleutel is niet gevonden | Controleer het eindpunt en of de sleutel bij hetzelfde account hoort |
| 413 | Te veel records of te groot | Verdeel het verzoek in kleinere delen |
| 422 | Er kon geen record worden opgeslagen | In het bericht staat welke records het identificatieveld missen of te groot zijn |
| 503 | Sendtric heeft het druk | Wacht het aantal seconden dat in de Retry-After-header staat, en stuur dan hetzelfde verzoek nog een keer |
Als slechts enkele records in een verzoek ongeldig zijn, worden de geldige records toch opgeslagen en worden de overige overgeslagen.
Controleer je gegevens
Open de gegevensbron en ga naar de tabblad 'Records' . Zoek op de waarde van de identificatiecode en klik op een record om de volledige JSON-gegevens te zien die Sendtric heeft opgeslagen.
Volgende stap
- Hoe gebruik je een gegevensbron in een gepersonaliseerde afbeelding?
- Hoe gebruik je een gegevensbron in een regelgebaseerde afbeelding?
- Hoe je een gegevensbron beheert, bewerkt en verwijdert
Was dit artikel nuttig?
Bedankt voor je feedback!
