Dokument unter Verwendung von HTTP erstellen

Die folgenden Schritte zeigen, wie ein Dokument mithilfe von HTTP erstellt wird.

1. Senden Sie eine PUT-Anforderung mit dem JSON-Inhalt des Dokuments, indem Sie HTTP zum Erstellen eines Dokuments verwenden.

2. Führen Sie den folgenden Befehl aus:

PUT /$DATABASE/$DOC_ID HTTP/1.1
Content-Type: application/json

Beispiele für das Erstellen eines Dokuments

Hier finden Sie ein Beispiel für die Erstellung eines „ IBM Cloudant “-Dokuments für dieses JSON in einer nicht partitionierten Datenbank:

{
   "type": "event",
   "userid": "abc123",
   "eventType": "addedToBasket",
   "productId": "1000042",
   "date": "2019-01-28T10:44:22.000Z"
}

Sie können die Erstellung eines Dokuments für die von Ihnen gewünschte Programmiersprache anpassen, indem Sie die Sprache in den Code-Beispielen auswählen.

Sehen Sie sich ein Beispiel für das Erstellen eines Dokuments an:

curl -H "Authorization: Bearer $API_BEARER_TOKEN" -X PUT "$SERVICE_URL/events/0007241142412418284" -H "Content-Type: application/json" --data '{ "type": "event", "userid": "abc123", "eventType": "addedToBasket", "productId": "1000042", "date": "2019-01-28T10:44:22.000Z }'

import com.ibm.cloud.cloudant.v1.Cloudant;
import com.ibm.cloud.cloudant.v1.model.Document;
import com.ibm.cloud.cloudant.v1.model.DocumentResult;
import com.ibm.cloud.cloudant.v1.model.PutDocumentOptions;
Cloudant service = Cloudant.newInstance();
Document eventDoc = new Document();
eventDoc.put("type", "event");
eventDoc.put("userid", "abc123");
eventDoc.put("eventType", "addedToBasket");
eventDoc.put("productId", "1000042");
eventDoc.put("date", "2019-01-28T10:44:22.000Z");
PutDocumentOptions documentOptions =
    new PutDocumentOptions.Builder()
        .db("events")
        .docId("0007241142412418284")
        .document(eventDoc)
        .build();
DocumentResult response =
    service.putDocument(documentOptions).execute()
        .getResult();
System.out.println(response);

const { CloudantV1 } = require('@ibm-cloud/cloudant');
const service = CloudantV1.newInstance({});
const eventDoc = {
  type: 'event',
  userid: 'abc123',
  eventType: 'addedToBasket',
  productId: '1000042',
  date: '2019-01-28T10:44:22.000Z'
};
service.putDocument({
  db: 'events',
  docId: '0007241142412418284',
  document: eventDoc
}).then(response => {
  console.log(response.result);
});

from ibmcloudant.cloudant_v1 import Document, CloudantV1
service = CloudantV1.new_instance()
event_doc = Document(
  type='event',
  userid='abc123',
  eventType='addedToBasket',
  productId='1000042',
  date='2019-01-28T10:44:22.000Z'
)
response = service.put_document(
  db='events',
  doc_id='0007241142412418284',
  document=event_doc
).get_result()
print(response)

eventDoc := cloudantv1.Document{}
eventDoc.SetProperty("type", "event")
eventDoc.SetProperty("userid", "abc123")
eventDoc.SetProperty("eventType", "addedToBasket")
eventDoc.SetProperty("productId", "1000042")
eventDoc.SetProperty("date", "2019-01-28T10:44:22.000Z")
putDocumentOptions := service.NewPutDocumentOptions(
  "events",
  "0007241142412418284",
)
putDocumentOptions.SetDocument(&eventDoc)
documentResult, response, err := service.PutDocument(putDocumentOptions)
if err != nil {
  panic(err)
}
b, _ := json.MarshalIndent(documentResult, "", "  ")
fmt.Println(string(b))

Das vorherige Go-Beispiel erfordert den folgenden Importblock:

import (
   "encoding/json"
   "fmt"
   "github.com/IBM/cloudant-go-sdk/cloudantv1"
)

Für alle Go-Beispiele muss das Objekt service initialisiert sein. Weitere Informationen finden Sie in den Beispielen im Abschnitt 'Authentifizierung' in der API-Dokumentation.

Die Antwort ist ein JSON-Dokument, das die ID des erstellten JSON-Dokuments, die Revisionszeichenfolge und die Angabe "ok": true enthält.

Wenn Sie kein Feld _id angegeben haben, IBM Cloudant erzeugt automatisch eine als UUID.

Wenn das Dokument nicht erstellt werden kann, enthält die Antwort eine Beschreibung des Fehlers.

Die folgende Beispielantwort wird nach der erfolgreichen Erstellung eines Dokuments zurückgegeben:

{
  "id": "exampleid",
  "ok": true,
  "rev": "2-056f5f44046ecafc08a2bc2b9c229e20"
}

Wenn das Schreibquorum bei dem Versuch, ein Dokument zu erstellen, nicht erreicht werden kann, wird die Antwort „ 202 “ zurückgegeben.