Endpointy

Pisanie strony sklepowej

Teksty strony sklepowej dla Google Play i App Store, napisane na podstawie tego, co mówią ekrany aplikacji.

POSThttps://www.setherion.com/api/v1/projects/{id}/store/listing

Plan: Pro and up

Pisze teksty strony sklepowej aplikacji za jednym razem, dla obu sklepów: nazwę, krótki i pełny opis w Google Play oraz podtytuł, słowa kluczowe i tekst promocyjny w App Store. To ta sama praca co przycisk Write it w oknie „Publish to app stores”, z tą samą zasadą planu, tą samą ceną i tym samym płatnikiem.

Teksty powstają na podstawie tego, co mówią ekrany aplikacji, w języku tych ekranów. Autorowi tekstów nakazano, by nigdy nie wymyślał funkcji, ceny, oceny ani liczby użytkowników i by nie wymieniał sklepów ani narzędzia, którym aplikację zrobiono.

Musisz mieć możliwość edycji aplikacji, bo to zużywa jej kredyty. Nic nie jest zapisywane: pokaż właścicielowi teksty, które ma skopiować do Play Console i App Store Connect.

Koszt i plan

Kredyty. Kilka, pobieranych przed pracą, z konta, które płaci za aplikację. Pole charged w odpowiedzi mówi, ile pobrano. Jeśli nie powstała żadna użyteczna strona, kredyty są zwracane.
Plan. Pro lub Business, konta, które płaci za aplikację. W planie Free wywołanie odpowiada 402.
Tempo. Ten sam godzinowy limit co przy innych małych akcjach AI w edytorze, 600 na godzinę na konto. Człowiek nigdy go nie osiąga.

Żądanie

Treść żądania nie jest potrzebna.

bash

curl -X POST https://www.setherion.com/api/v1/projects/7c1e4a52-9b0d-4f3e-8a61-2d5f0c9e7b14/store/listing \
  -H "Authorization: Bearer $SETHERION_API_KEY"

Trwa do około dwóch minut. Ustaw limit czasu swojego klienta na co najmniej 2 minuty.

Odpowiedź

json

{
  "ok": true,
  "language": "en",
  "charged": 2,
  "limits": {
    "name": 30,
    "googleShort": 80,
    "description": 4000,
    "appleSubtitle": 30,
    "appleKeywords": 100,
    "applePromo": 170
  },
  "texts": {
    "name": "Coffee Shop",
    "googleShort": "Order your coffee and cake ahead and skip the queue.",
    "description": "Coffee Shop is for anyone in Leeds who wants a good coffee without waiting. Browse the menu, choose what you like and collect it when it is ready.\n\n• Browse the full menu with prices\n• Order ahead for collection\n• See the opening hours\n• Find the shop on the map\n\nPick your favourite and skip the queue.",
    "appleSubtitle": "Order ahead, skip the queue",
    "appleKeywords": "coffee,cafe,order ahead,takeaway,cake,Leeds",
    "applePromo": "Your morning coffee, ready when you arrive. Open the menu, order ahead and collect it without waiting."
  }
}

Pole	Typ	Znaczenie
`language`	string	Kod języka, w którym napisano teksty, odczytany z ekranów aplikacji.
`charged`	number	Pobrane kredyty. `0`, gdy nie udało się połączyć z rejestrem kredytów i wywołanie zostało przepuszczone.
`limits`	object	Największa liczba znaków, jaką może mieć każde pole. To limity samych sklepów.
`texts`	object	Teksty. Każde pole jest zawsze obecne.

Pola `texts`

Pole	Dokąd trafia	Limit
`name`	Nazwa aplikacji w obu sklepach	30 znaków
`googleShort`	Google Play, krótki opis	80 znaków
`description`	Pełny opis, taki sam w obu sklepach	4 000 znaków
`appleSubtitle`	App Store, podtytuł	30 znaków
`appleKeywords`	App Store, słowa kluczowe, oddzielone przecinkami bez spacji	100 znaków
`applePromo`	App Store, tekst promocyjny	170 znaków

Każde pole jest przycinane do swojego limitu na granicy całego słowa, bo konsola sklepu odrzuca pole ponad limit, a model źle liczy znaki. Słowa kluczowe też są oczyszczane: każde występuje raz i żadne nie powtarza słowa z nazwy. Pełny opis to zwykły tekst, a najważniejsze rzeczy, które ludzie mogą zrobić, są po jednej w wierszu, każda zaczyna się od •.

Błędy

Status	Kiedy
`401`	Klucza brakuje, jest błędny albo unieważniony.
`402`	Konto, które płaci za aplikację, ma plan Free albo skończyły mu się kredyty, albo osiągnięto limit przestrzeni roboczej nałożony na ciebie.
`404`	Nie ma takiej aplikacji albo twój klucz nie może jej edytować.
`409`	Aplikacja nie ma jeszcze kodu. Najpierw zbuduj ją w Setherion.
`429`	Ponad 600 małych akcji AI w ostatniej godzinie na tym koncie.
`500`	Nie udało się użyć odpowiedzi autora tekstów. Nic nie jest pobierane: kredyty są zwracane. Spróbuj ponownie.
`503`	Ogranicznik jest chwilowo niedostępny, więc nic nie uruchomiono. Spróbuj ponownie za minutę.

Dokładne zdania

Status	`error`
`402`	`Writing the store page is part of the Pro plan.`
`402`	`This costs 2 credits and you have 1.`
`402`	`This app's owner has no credits left this month.`
`402`	`You have used the credits this workspace allows you this month. Ask an admin to raise your limit.`
`404`	`No such app on this account.`
`409`	`This app has no code yet. Build it in Setherion first.`
`429`	`Too many AI actions in the last hour. Try again later.`
`500`	`The model did not answer with the store page.`
`500`	`The model's answer was cut off or not readable.`
`500`	`The model left out: appleKeywords.`
`503`	`Usage limits are briefly unavailable, so this was not run. Try again in a minute.`

Pierwszy 402 dotyczy planu Free. Liczby w drugim to cena i twój stan konta; przy cudzej aplikacji dostajesz zamiast tego trzecie zdanie, które nigdy nie podaje stanu konta właściciela. Wiersze 500 są przykładami: zdanie nazywa, co poszło nie tak, a kredyty są zwracane.

Czy ta strona była pomocna?

Wstecz

Odpowiedzi o prywatności w sklepach

Dalej

Serwer MCP

Dołącz do społeczności