Ga naar hoofdinhoud

Snel aan de slag

De Predis.ai API geeft ontwikkelaars programmatische toegang tot de Predis.ai's contentcreatiestroom. De API is een RESTful JSON API waarmee u kunt communiceren vanuit elke taal of elk raamwerk met een HTTP-bibliotheek.

Als je vragen hebt, voel maar free om contact met ons op te nemen via [e-mail beveiligd].

Stap 1: Meld u aan om een API sleutel​

Je hebt een API sleutel om de te gebruiken Predis.ai API.

  • Log in op app.predis.ai
  • Navigeer naar Prijzen & Account -> Rest API om een ​​nieuwe te genereren API sleutel
  • U moet de onboarding-flow voltooien om toegang te krijgen tot het menu

Stap 2: Configureer Webhook​

U moet ook een webhook configureren om meldingen in uw app te ontvangen wanneer de berichten met succes zijn gemaakt (of als ze mislukken). Zodra het maken van het bericht slaagt of mislukt, sturen we een POST verzoek op uw geconfigureerde URL.

  • Navigeer naar Prijzen & Account -> Rest API om uw webhook-URL toe te voegen

Stap 3: Haal uw merk-ID op​

Al je berichten gemaakt op basis van de Predis app bevindt zich in een bepaald merk. Hetzelfde concept is van toepassing op de berichten die zijn gemaakt via API te. Je moet een merk-ID doorgeven in het verzoek om berichten te maken, zodat de berichten onder het juiste merk worden gemaakt. Lees meer over Merken hier.

  • Ga naar Prijzen & Account -> Merken om uw merk-ID te verkrijgen

Stap 4: Berichten maken​

Je bent nu klaar om programmatisch berichten te maken met behulp van Predis.ai's contentcreatie API. Hieronder ziet u een snel voorbeeld dat laat zien hoe de API call kan in Python worden geïmplementeerd met behulp van de requests bibliotheek.

Voorbeeld​

import requests

url = "https://brain.predis.ai/predis_api/v1/create_content/"

payload = {
  "brand_id": "YOUR_BRAND_ID",
  "text": "3 tips for a healthy morning breakfast",
  "media_type": "single_image"
}

headers = {"Authorization": "YOUR_API_KEY"}

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

print(response.text)
# {
#     "post_ids": [
#         "CREATED_POST_ID"
#     ],
#     "post_status": "inProgress",
#     "errors": []
# }

Bij een succesvol verzoek zou u een antwoord zoals hierboven moeten zien met de details over het gemaakte bericht. Zodra het bericht enige status heeft (succes of mislukking) zou u een verzoek op uw webhook-URL moeten krijgen met meer details. Lees meer over de responsparameters hier en de webhookverzoekparameters hier

Aanvullende bronnen​