1.1.3 Werken met Photoshop API's

Leer hoe u met de Photoshop API's en Firefly Services werkt.

1.1.3.1 Voorwaarden

Alvorens met deze oefening verder te gaan, moet u de opstelling van ​ uw project van Adobe I/O ​ hebben voltooid, en u moet ook een toepassing gevormd hebben om met APIs, zoals ​ Postman ​ of ​ PostBuster ​ in wisselwerking te staan.

1.1.3.2 Adobe I/O - access_token

In Adobe IO - OAuth inzameling, selecteer het verzoek genoemd POST - krijg het Token van de Toegang en selecteer verzend. De reactie zou een nieuwe versnelling moeten bevatten.

1.1.3.3 Programmaticaal communiceren met een PSD-bestand

Download ​ burgerschap-fiber.psd ​ aan uw Desktop.

Open burgerschap-fiber.psd in Photoshop.

In de ruit van Lagen, heeft de ontwerper van het dossier een unieke naam aan elke laag gegeven. U kunt de laaginformatie zien door het PSD-bestand te openen in Photoshop, maar u kunt dit ook via programmacode doen.

Stuur uw eerste API-aanvraag naar Photoshop API's.

Photoshop API - Hello World

Laten we nu de groeten overbrengen aan Photoshop API's om te testen of alle machtigingen en toegangsrechten correct zijn ingesteld.

In de inzameling Photoshop, open verzoek Photoshop Hello (de Auth van de Test.). Selecteer verzenden.

U zou het antwoord Onthaal aan Photoshop API moeten ontvangen!.

Daarna, om programmatically met het dossier van PSD te interactie aan te gaan Citisignaal-fiber.psd, moet u het aan uw opslagrekening uploaden. U kunt dat handmatig doen, door het bestand met Azure Storage Explorer naar uw container te slepen en neer te zetten, maar dit keer moet u het doen via de API.

PSD uploaden naar Azure

In Postman, open het verzoek uploadt PSD aan Azure Rekening van de Opslag. In de vorige oefening, vormde u deze milieuvariabelen in Postman, die u nu zult gebruiken:

Aangezien u in het verzoek kunt zien uploadt PSD aan Azure Rekening van de Opslag, wordt URL gevormd om deze variabelen te gebruiken.

In Lichaam, selecteer het dossier burgerschap-fiber.psd.

Het scherm moet er zo uitzien. Selecteer verzenden.

Deze lege reactie moet u terugkrijgen vanuit Azure, wat betekent dat uw bestand in uw container wordt opgeslagen in uw Azure Storage-account.

Als u Azure Storage Explorer gebruikt om uw bestand te bekijken, moet u de map vernieuwen.

Photoshop API - Get manifest

Vervolgens moet u het manifestbestand van uw PSD-bestand ophalen.

In Postman, open het verzoek Photoshop - krijg PSD Manifest. Ga naar Lichaam.

Het lichaam moet er als volgt uitzien:

  {
    "inputs": [
      {
        "storage": "external",
        "href": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/citisignal-fiber.psd{{AZURE_STORAGE_SAS_READ}}"
      }
    ],
    "options": {
      "thumbnails": {
        "type": "image/jpeg"
      }
    }
  }

Selecteer verzenden.

In het antwoord ziet u nu een koppeling. Aangezien het soms enige tijd kan duren om bewerkingen in Photoshop uit te voeren, verschaft Photoshop een statusbestand als antwoord op de meeste binnenkomende aanvragen. Als u wilt weten wat er met uw verzoek gebeurt, moet u het statusbestand lezen.

Om het statusdossier te lezen, open het verzoek Photoshop - krijgt PS Status. U kunt zien dat dit verzoek een variabele als URL gebruikt, die een variabele is die door het vorige verzoek wordt geplaatst dat u verzendt, Photoshop - krijgt PSD Manifest. De variabelen worden geplaatst in Manuscripten van elk verzoek. Selecteer verzenden.

Het scherm moet er zo uitzien. Momenteel, wordt de status geplaatst aan hangend, wat betekent dat het proces nog niet heeft voltooid.

Selecteer verzenden een paar meer tijden op Photoshop - krijgt PS Status, tot de statusveranderingen in succesvol. Dit kan een paar minuten duren.

Wanneer de reactie beschikbaar is, ziet u dat het JSON-bestand informatie bevat over alle lagen van het PSD-bestand. Dit is nuttige informatie, aangezien de dingen zoals de laagnaam of laagidentiteitskaart kunnen worden geïdentificeerd.

Zoek bijvoorbeeld naar de tekst 2048x2048-cta . Uw scherm moet er als volgt uitzien:

Photoshop API - SmartObject Replace

Vervolgens moet u de achtergrond van het bestand Citisignaal-fiber.psd wijzigen door de afbeelding te gebruiken die u in een van de vorige oefeningen met Firefly hebt gegenereerd.

In Postman, open het verzoek Photoshop - SmartObject vervangt en gaat naar Lichaam.

Uw scherm moet er als volgt uitzien:

  {
    "inputs": [
        {
            "storage": "azure",
            "href": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/citisignal-fiber.psd{{AZURE_STORAGE_SAS_READ}}"
        }
    ],
    "options": {
        "layers": [
            {
                "name": "2048x2048-image",
                "input": {
                    "href": "{{FIREFLY_COMPLETED_ASSET_URL}}",
                    "storage": "external"
                }
            }
        ]
    },
    "outputs": [
        {
            "storage": "azure",
            "href": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/citisignal-fiber-replacedbg.psd{{AZURE_STORAGE_SAS_WRITE}}",
            "type": "vnd.adobe.photoshop",
            "overwrite": true
        }
    ]
}

Het uitvoerbestand heeft een andere naam, omdat u het oorspronkelijke invoerbestand niet wilt overschrijven.

Selecteer verzenden.

Net als voorheen bevat het antwoord een koppeling die verwijst naar het statusbestand en de voortgang bijhoudt.

Om het statusdossier te lezen, open het verzoek Photoshop - krijg PS Status en selecteer verzend. Als de status niet aan wordt geplaatst slaagde onmiddellijk, wacht een paar seconden en selecteert dan verzend opnieuw.

Selecteer de URL om het uitvoerbestand te downloaden.

Open burgerschap-vezel-vervangt bg.psd na het downloaden van het dossier aan uw computer. De achtergrondafbeelding is gewijzigd in een vergelijkbare afbeelding, zoals hieronder:

U kunt dit bestand ook in uw container zien met Azure Storage Explorer.

Photoshop API - Tekst wijzigen

Vervolgens moet u de tekst voor de call to action wijzigen met de API's.

In Postman, open het verzoek Photoshop - de Tekst van de Verandering en ga naar Lichaam.

Uw scherm moet er als volgt uitzien:

  {
  "inputs": [
    {
      "storage": "external",
      "href": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/citisignal-fiber-replacedbg.psd{{AZURE_STORAGE_SAS_READ}}"
    }
  ],
  "options": {
    "layers": [
      {
        "name": "2048x2048-cta",
        "text": {
          "content": "Get Fiber now!"
        }
      }
    ]
  },
  "outputs": [
    {
      "storage": "azure",
      "href": "{{AZURE_STORAGE_URL}}/{{AZURE_STORAGE_CONTAINER}}/citisignal-fiber-changed-text.psd{{AZURE_STORAGE_SAS_WRITE}}",
      "type": "vnd.adobe.photoshop",
      "overwrite": true
    }
  ]
}

Het uitvoerbestand heeft een andere naam, omdat u het oorspronkelijke invoerbestand niet wilt overschrijven.

Selecteer verzenden.

Net als voorheen bevat het antwoord een koppeling die verwijst naar het statusbestand en de voortgang bijhoudt.

Om het statusdossier te lezen, open het verzoek Photoshop - krijg PS Status en selecteer verzend. Als de status niet aan wordt geplaatst slaagde onmiddellijk, wacht een paar seconden en selecteert dan verzend opnieuw.

Selecteer de URL om het uitvoerbestand te downloaden.

Open burgerschap-vezel-veranderd-text.psd na het downloaden van het dossier aan uw computer. U zou placeholder voor call to action moeten zien is vervangen door de tekst krijgt nu Vezel!.

U kunt dit bestand ook in uw container zien met Azure Storage Explorer.

Volgende stappen

Ga naar ​ Firefly Eigen Modellen API ​

Ga terug naar ​ Overzicht van Adobe Firefly Services ​

Ga terug naar ​ Alle Modules ​