media

Stockfoto oder -video importieren

Kopiert ein Suchergebnis anhand von Anbieter und ID in die Medien der Website (Bilder mit maximal 2400 px Breite, Videos mit maximal Full HD), einschließlich Alternativtext und Quellenangabe. Kostenlos.

POST/v1/sites/{site_id}/media/stock

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "pixabay",
  "id": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media/stock"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")

response = requests.request("POST", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media/stock", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "provider": "pixabay",
    "id": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media/stock");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"provider\":\"pixabay\",\"id\":\"<string>\"}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

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

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/media/stock", bytes.NewBuffer([]byte("{\"provider\":\"pixabay\",\"id\":\"<string>\"}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media/stock"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"provider\":\"pixabay\",\"id\":\"<string>\"}"))
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media/stock")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"provider\":\"pixabay\",\"id\":\"<string>\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "path": "<string>",
    "url_path": "<string>",
    "mime": "<string>",
    "size": 123,
    "alt": null,
    "credit": null,
    "source_url": null,
    "keep_original": true,
    "source": {},
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Erfordert sites:write. Kostet keine Credits.

Sende provider und id aus der Suche. Die Datei wird in die Medien des Standorts kopiert: Fotos sind höchstens 2400 Pixel breit, Videos maximal in Full HD und höchstens 20 MB groß. Ist ein Name bereits vergeben, wird ein Suffix angehängt. So wird beim Import keine vorhandene Datei ersetzt.

Die Mediendatei behält credit (“Photo by Jane Doe on Pixabay”) und source_url. Pixabay verlangt keine Quellenangabe auf dem Standort, eine kurze Credits-Zeile ist jedoch empfehlenswert.

Stockbilder schaffen Atmosphäre. Sie ersetzen niemals echte Produkte, Personen oder Räumlichkeiten des Unternehmens.

Pro Workspace sind insgesamt höchstens 30 Suchen und Importe pro Minute möglich, genauso wie bei der Suche.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Body

application/jsonrequired

providerenum<string>requiredone of: pixabay

idstringrequiredlength: 1–20 chars

Die ID des Ergebnisses aus der Suche.

kindenum<string>one of: image, video

filenamestringlength: 1–100 chars

Ein Name ohne Dateiendung. Standardmäßig wird die Beschreibung verwendet.

altstringlength: ≤ 300 chars

Was darauf zu sehen ist, für Personen, die es nicht sehen können. Standardmäßig wird die Beschreibung der Bibliothek verwendet.

Antwort

application/json

Stockfoto oder -video importieren

dataRecord<string, object>required

Show child attributes

data.pathstringrequired

data.url_pathstringrequired

data.mimestringrequired

data.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.altstringnullrequired

data.creditstringnullrequired

Wer es erstellt hat, sofern eine Lizenzangabe erforderlich ist: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Bei Uploads null.

data.source_urlstringnullrequired

Die Stock-Seite, von der es stammt, oder null.

data.keep_originalbooleanrequired

Wird exakt so gespeichert, wie hochgeladen, und beim Build nie neu kodiert. Andernfalls wird ein Bild über 200 KB beim Eingang komprimiert (maximal 2000 px, Zielgröße etwa 150 KB, Qualität mindestens 75, Metadaten entfernt).

data.sourceRecord<string, object>required

data.next_actionstringrequired

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/media/stock' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "provider": "pixabay", "id": "<string>" }'

{ "data": { "path": "<string>", "url_path": "<string>", "mime": "<string>", "size": 123, "alt": null, "credit": null, "source_url": null, "keep_original": true, "source": {}, "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Stockfoto oder -video importieren

Autorisierung

Pfadparameter

Body

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies