Gebeurtenistypen kiezen

Standaard ontvangt u elk gebeurtenistype van elk account dat u monitort. U kunt dat per account beperken: het ene account stuurt u alleen zijn nieuwe geverifieerde volgers, het andere alles wat het plaatst. De keuze hoort bij het abonnement en wordt dus voor elk account apart gemaakt.

Wat u kunt kiezen

Elk gebeurtenistype hieronder kan per account afzonderlijk aan- of uitgezet worden. Trefwoordtreffers (search.match) staan niet in de lijst: die komen van trefwoorden, niet van accounts.

Type	Categorie	Betekenis
`tweet.create`	Berichten	Het account plaatste iets nieuws
`tweet.reply`	Berichten	Het reageerde op iemand; `reply_to` bevat het bericht waarop werd gereageerd, met tekst en media
`tweet.retweet`	Berichten	Het repostte iemand; `retweet_of` bevat het oorspronkelijke bericht volledig
`tweet.quote`	Berichten	Het citeerde iemand; `quoted` bevat het geciteerde bericht volledig
`tweet.edit`	Berichten	Het bewerkte een bericht; de gebeurtenis bevat de nieuwe versie, en `edit_of` de versie die ze vervangt
`tweet.delete`	Berichten	Een bericht dat het account had gepubliceerd is verdwenen
`profile.name`	Profiel	Weergavenaam gewijzigd
`profile.screen_name`	Profiel	Handle gewijzigd
`profile.bio`	Profiel	Bio gewijzigd
`profile.location`	Profiel	Locatie gewijzigd
`profile.url`	Profiel	Profiellink gewijzigd
`profile.avatar`	Profiel	Avatar gewijzigd; `old` en `new` zijn afbeeldings-URL's
`profile.banner`	Profiel	Banner gewijzigd; `old` en `new` zijn afbeeldings-URL's
`profile.pinned`	Profiel	Vastgezet bericht gewijzigd; `tweet` en `old_tweet` bevatten de berichten zelf
`profile.verified`	Profiel	Verificatiebadge verschenen of verdwenen
`follow.add`	Volgrelaties	Het account is iemand gaan volgen; `user` is het volledige profiel van dat account
`follow.remove`	Volgrelaties	Het account volgt iemand niet meer
`followers.verified.add`	Volgrelaties	Een geverifieerd account is het gaan volgen; `user` bevat bio, aantallen, locatie en registratiedatum
`account.status`	Account	Het account werd beschermd, geschorst of niet beschikbaar, of weer actief

Veelgebruikte keuzes

Stuur de waarde uit de rechterkolom als event_types. Typen zijn vrij te combineren; noem er zoveel als u nodig hebt.

U wilt	`event_types`
Alleen nieuwe geverifieerde volgers van het account	`["followers.verified.add"]`
Alleen zijn eigen berichten	`["tweet.create"]`
Alleen zijn antwoorden	`["tweet.reply"]`
Alles wat het publiceert: berichten, antwoorden, reposts, citaten en bewerkingen	`["tweet.create", … 5 typen]`
Zijn berichten, en wanneer het er een verwijdert	`["tweet.create", "tweet.delete"]`
Alleen profielwijzigingen (alle negen profieltypen)	`["profile.name", … 9 typen]`
Alleen wie het gaat volgen en ontvolgt	`["follow.add", "follow.remove"]`
Alles (standaard)	`null`

Zo stelt u het in

Kies bij het starten van de monitoring, of wijzig het daarna op elk moment. Beide aanroepen vereisen de scope targets:write.

Monitoring starten met een keuze

curl -X POST https://api.xsignalfeed.com/v1/monitor/targets \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"screen_name": "elonmusk", "event_types": ["followers.verified.add"]}'

De keuze later wijzigen

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": ["tweet.create", "tweet.reply"]}'

Terug naar alle typen

curl -X PATCH https://api.xsignalfeed.com/v1/monitor/targets/elonmusk \
  -H "Authorization: Bearer xsf_your_key" -H "Content-Type: application/json" \
  -d '{"event_types": null}'

De huidige keuze van het account staat in het veld event_types; event_types_all is true als er niets wordt weggefilterd.

GET /v1/monitor/targets/elonmusk

{
  "target": {
    "id": "44196397",
    "screen_name": "elonmusk",
    "name": "Elon Musk",
    "state": "subscribed",
    "…": "…",
    "event_types": [
      "tweet.create",
      "tweet.reply"
    ],
    "event_types_all": false
  }
}

Regels

event_types weglaten bij het starten van de monitoring betekent alle typen.
event_types sturen vervangt de hele keuze; er wordt niets aan toegevoegd. De monitoringaanroep opnieuw sturen zonder event_types behoudt de huidige keuze.
null of [] betekent alle typen. Alle typen uit de lijst kiezen wordt op dezelfde manier opgeslagen.
De keuze geldt gelijk voor de stream, webhooks en GET /v1/events. Een open verbinding neemt een wijziging mee bij haar volgende verversing, niet direct.
Een update die het type van een bericht verandert (met kind_was) bereikt u als een van beide typen in uw keuze zit. Neemt u tweet.create maar niet tweet.quote, dan krijgt u toch de update die laat zien dat een bericht een citaat was, zodat u het kunt laten vallen; neemt u tweet.quote maar niet tweet.create, dan bereikt zo'n citaat u eerst als die update.
Verruim de keuze en de toegevoegde typen komen vanaf dat moment binnen. Gebeurtenissen van die typen van vóór de wijziging zijn niet gegarandeerd beschikbaar via GET /v1/events.
Een sleutel kan ook een lijst voor de hele sleutel hebben, die wij op uw verzoek instellen (event_types in GET /v1/account). Een gebeurtenis bereikt u alleen als beide lijsten haar toestaan.
Een onbekend type wordt geweigerd met 400 invalid_request; details.unknown noemt het en details.allowed somt op wat u kunt gebruiken. GET /v1/meta/event-types geeft de volledige lijst.
Trefwoorden kiest u per trefwoord, niet hier: volg een trefwoord of stop ermee om de search.match-gebeurtenissen ervan te ontvangen of niet meer te ontvangen.

Wat niet te kiezen is

Nieuwe volgers die niet geverifieerd zijn worden niet als gebeurtenis aangeboden en zijn dus niet te kiezen. Alleen nieuwe geverifieerde volgers wel (followers.verified.add).
U kiest alleen op gebeurtenistype, niet op inhoud. Voorwaarden als "geverifieerde volgers met meer dan 10.000 volgers", "alleen berichten met afbeeldingen" of "alleen in het Engels" past u zelf toe, met de velden in de payload (bijvoorbeeld user.followers, media, lang).