Writing orders

Order an article

The response is the order, with status: "NOUA". When it is done, the same order has status: "LIVRATA" and articleId filled in.

It is paid from the money balance, not from credits. A credit is “one publication included” from a package, not hours of writing. The price is reserved the moment the order arrives and consumed on delivery; a rejection, a cancellation or a writing failure on our side releases it in full. With no balance the order is refused with 400 and is not created at all — better a refusal at the door than an article written on credit.

fapte is the one measured field that changes the quality of the text. With the client's data in front of it, the article uses their exact figures; without it, it stays general — correct, but less useful. The rule is strict: only what appears there may appear in the article as a figure or a name.

Required scope: ARTICLES_WRITE.

post/partner/redactare

Request

  • Base URL: https://app.comunicate.eu/api/v1
  • URL: https://app.comunicate.eu/api/v1/partner/redactare
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.comunicate.eu/api/v1/oauth/authorize, token URL https://app.comunicate.eu/api/v1/oauth/token, scopes: ARTICLES_WRITE)

Request body

temastring required

One sentence, as you would tell a writer. The title comes from it.

campaignTypestring required

One of the types from campaign-types.

cuvinte'500' | '700' | '1000' | '1500' required

Target length.

cuvantCheiestring

One only, one to four words.

brandstring

The promoted brand.

adresaPromovatastring

The URL the article points to.

faptestring

One item per entry: prices, years in business, certifications, who can be quoted.

campaignIdstring uuid

The campaign the delivered article joins.

notestring

Anything else you want to tell us about the order.

idempotencyKeystring

Chosen by you — a locally generated UUID is enough. Sent again with exactly the same data, it returns the order already created instead of making a new one. Recommended for any code that might resend the request after a timeout: without a key, a resend creates a second order and a second money reservation.

Response

OK

object required

Changes

No recorded changes to this operation across all 1 revision of this API.