PDP-Fragenset abrufen - homie Documentation

Get PDP Question Set

curl --request GET \
  --url https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public

import requests

url = "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{}

GET

knowledge

pdp-questions

{organizationId}

public

Get PDP Question Set

curl --request GET \
  --url https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public

import requests

url = "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.yourhomie.ai/v1/knowledge/pdp-questions/{organizationId}/public")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{}

Rufe die vorgeschlagenen Fragen für eine bestimmte Produktdetailseite (PDP) ab. Dieser Endpunkt ist öffentlich und CORS-fähig, sodass du ihn direkt aus dem Browser eines Storefronts aufrufen kannst.

Dies ist der einzige öffentliche Endpunkt der REST API. Er benötigt keinen x-api-key-Header.

Request

organizationId

string

erforderlich

ID der Organisation, der das Fragenset gehört.

url

string

erforderlich

Die URL der Produktdetailseite. Der Server kanonisiert die URL vor dem Abgleich.

Response

Die Response ist ein PdpQuestionsSetDto.

string

erforderlich

ID des Fragensets.

organizationId

string

erforderlich

ID der Organisation, der das Fragenset gehört.

url

string

erforderlich

Die kanonisierte PDP-URL, zu der das Fragenset gehört.

productTitle

string

Titel des Produkts oder null, wenn unbekannt.

requests

integer

Anzahl, wie oft das Fragenset angefragt wurde.

createdAt

string

erforderlich

ISO-8601-Zeitstempel, wann das Fragenset erstellt wurde.

questions

object[]

erforderlich

Die vorgeschlagenen Fragen, sortiert nach Rang.

Anzeigen PdpQuestionDto

string

erforderlich

ID der Frage.

text

string

erforderlich

Der Fragetext.

rank

integer

erforderlich

Priorität der Frage. 1 ist die höchste Priorität.

Beispiele

curl -G https://api.yourhomie.ai/v1/knowledge/pdp-questions/11111111-2222-3333-4444-555555555555/public \
  --data-urlencode "url=https://shop.example.com/p/produkt-abc-12345"

const organizationId = "11111111-2222-3333-4444-555555555555";
const pdpUrl = "https://shop.example.com/p/produkt-abc-12345";

const res = await fetch(
  `https://api.yourhomie.ai/v1/knowledge/pdp-questions/${organizationId}/public?url=${encodeURIComponent(pdpUrl)}`,
);

const questionSet = await res.json();

Erfolgreiche Response

{
  "id": "49113e90-6e30-42d1-8c02-a697c6b47f01",
  "organizationId": "11111111-2222-3333-4444-555555555555",
  "productTitle": null,
  "url": "https://shop.example.com/p/produkt-abc-12345",
  "requests": 12,
  "createdAt": "2025-10-16T11:44:41.140Z",
  "questions": [
    {
      "id": "f5ae1f7e-9680-497a-b2d6-afbbb1203408",
      "text": "What are the dimensions of the product?",
      "rank": 1
    },
    {
      "id": "8e0ab7fe-0e23-4efe-835b-8106f9cca314",
      "text": "What material is it made of?",
      "rank": 2
    }
  ]
}

Fehler-Response

{
  "message": "No question set found for this URL"
}

Pfadparameter

organizationId

string

erforderlich

Abfrageparameter

url

string

erforderlich

Antwort

200 - application/json

The response is of type object.

Nachrichten-Events Einführung

​Request

​Response

​Beispiele

​Erfolgreiche Response

​Fehler-Response

Pfadparameter

Abfrageparameter

Antwort

Request

Response

Beispiele

Erfolgreiche Response

Fehler-Response