Fetch comments from a stream (legacy)

/api/v1/datasets/<project>/<dataset_name>/streams/<stream_name>/fetch

Erforderliche Berechtigungen: Streams verbrauchen, Beschriftungen anzeigen, Quellen anzeigen.

• Bash

  curl -X POST 'https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/fetch' \
      -H "Authorization: Bearer $REINFER_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{
    "size": 8
  }'

• Knoten

  const request = require("request");
  
  request.post(
    {
      url: "https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/fetch",
      headers: {
        Authorization: "Bearer " + process.env.REINFER_TOKEN,
      },
      json: true,
      body: { size: 8 },
    },
    function (error, response, json) {
      // digest response
      console.log(JSON.stringify(json, null, 2));
    }
  );

• Python

  import json
  import os
  
  import requests
  
  response = requests.post(
      "https://<my_api_endpoint>/api/v1/datasets/project1/collateral/streams/dispute/fetch",
      headers={"Authorization": "Bearer " + os.environ["REINFER_TOKEN"]},
      json={"size": 8},
  )
  
  print(json.dumps(response.json(), indent=2, sort_keys=True))

• Antwort

  {
    "filtered": 6,
    "is_end_sequence": false,
    "results": [
      {
        "comment": {
          "context": "1",
          "created_at": "2018-10-15T15:39:51.815000Z",
          "id": "0123456789abcdef",
          "last_modified": "2018-10-15T15:39:51.815000Z",
          "messages": [
            {
              "body": {
                "text": "Hi Bob,\n\nCould you send me today's figures?"
              },
              "from": "[e-mail]",
              "sent_at": "2011-12-11T11:02:03.000000+00:00",
              "signature": {
                "text": "Thanks,\nAlice"
              },
              "subject": {
                "text": "Today's figures"
              },
              "to": ["[e-mail]"]
            }
          ],
          "source_id": "18ba5ce699f8da1f",
          "text_format": "plain",
          "thread_id": "3c314542414538353242393446393",
          "timestamp": "2011-12-11T01:02:03.000000+00:00",
          "uid": "18ba5ce699f8da1f.0123456789abcdef",
          "user_properties": {
            "number:Participants": 2,
            "number:Position in Thread": 1,
            "number:Recipients": 1,
            "string:Folder": "Sent (/ Sent)",
            "string:Has Signature": "Yes",
            "string:Message ID": "<[e-mail]>",
            "string:Sender": "[e-mail]",
            "string:Sender Domain": "company.com",
            "string:Thread": "<[e-mail]>"
          }
        },
        "entities": [],
        "labels": [],
        "sequence_id": "qs8QcHIBAACuYzDeit-pwQdWGYGQImdy"
      },
      {
        "comment": {
          "context": "1",
          "created_at": "2018-10-15T18:39:51.815000Z",
          "id": "abcdef0123456789",
          "last_modified": "2018-10-15T18:39:51.815000Z",
          "messages": [
            {
              "body": {
                "text": "Alice,\n\nHere are the figures for today."
              },
              "from": "[e-mail]",
              "sent_at": "2011-12-11T11:02:03.000000+00:00",
              "signature": {
                "text": "Regards,\nBob"
              },
              "subject": {
                "text": "RE: Today's figures"
              },
              "to": ["[e-mail]"]
            }
          ],
          "source_id": "18ba5ce699f8da1f",
          "text_format": "plain",
          "thread_id": "3c314542414538353242393446393",
          "timestamp": "2011-12-11T02:02:03.000000+00:00",
          "uid": "18ba5ce699f8da1f.abcdef0123456789",
          "user_properties": {
            "number:Participants": 3,
            "number:Position in Thread": 2,
            "number:Recipients": 2,
            "string:Folder": "Inbox (/ Inbox)",
            "string:Has Signature": "No",
            "string:Message ID": "[e-mail]",
            "string:Sender": "[e-mail]",
            "string:Sender Domain": "organisation.org",
            "string:Thread": "<[e-mail]>"
          }
        },
        "entities": [],
        "labels": [
          {
            "name": ["Some Top-Level Label"],
            "probability": 0.8374786376953125
          },
          {
            "name": ["Another Top-Level Label", "Child Label"],
            "probability": 0.6164003014564514
          }
        ],
        "sequence_id": "qs8QcHIBAADJ1p3W2FtmBB3QiOJsCJlR"
      }
    ],
    "sequence_id": "qs8QcHIBAADJ1p3W2FtmBB3QiOJsCJlR",
    "status": "ok"
  }

Sobald ein Stream erstellt wurde, kann er abgefragt werden, um Kommentare und deren vorhergesagte Beschriftungen und allgemeine Felder abzurufen. Im Folgenden finden Sie einige wichtige Aspekte, die beim Abrufen von Kommentaren aus einem Stream beachtet werden sollten.