← Cloudflare R2 / r2 / tutorials

Postman

Postman je platforma pro API, která usnadňuje práci s API. Tento návod vysvětluje, jak pomocí Postmanu odesílat ověřené požadavky R2, vytvořit bucket, nahrát nový objekt a poté tento objekt načíst. R2 Kolekce Postman ↗ obsahuje úplný seznam operací podporovaných platformou.

Tento návod předpokládá, že už máte vytvořený účet Cloudflare a zakoupenou službu R2.

Prohlédněte si veřejně dostupnou R2 Kolekce Postman ↗. Kolekce je uspořádána do Buckets složku pro operace na úrovni bucketu a Objects složku pro operace na úrovni objektu. Operace ve složce Objects > Upload složka umožňuje přidávání nových objektů do R2.

V Dashboard Postman ↗, vyberte Cloudflare R2 kolekce a přejděte na Proměnné kartě. V Proměnné, můžete nastavit proměnné v rámci kolekce R2. Budou použity k ověřování a práci s platformou R2. Nezapomeňte vždy vybrat Save po aktualizaci proměnné.

Chcete-li provádět základní operace, musíte nastavit account-id, r2-access-key-id, a r2-secret-access-key proměnné v dashboardu Postman > Proměnné.

Chcete-li to provést:

1. V dashboardu Cloudflare přejděte na Objektové úložiště R2 stránce.

   Přejděte na Přehled ↗

2. V R2, v části Správa tokenů R2 API na pravé straně dashboardu zkopírujte své Cloudflare account ID.

3. Vraťte se zpět na Dashboard Postman ↗.

4. Nastavte AKTUÁLNÍ HODNOTA z account-id na ID vašeho účtu Cloudflare a vyberte Save.

Dále vygenerujte token R2 API:

1. V dashboardu Cloudflare přejděte na Objektové úložiště R2 stránce.

   Přejděte na Přehled ↗

2. V pravém postranním panelu vyberte Správa tokenů R2 API.

3. Vyberte Vytvoření API tokenu.

4. Pojmenujte svůj token Postman výběrem ikony tužky vedle názvu API a udělte mu Úprava oprávnění.

Chraňte tento token a Access Key ID a Secret Access Key pečlivě. Po dokončení tohoto kroku už tyto hodnoty nebudete moci znovu zobrazit. Kdokoli s těmito informacemi může plně pracovat se všemi vašimi buckety.

Po vytvoření API tokenu v Cloudflare dashboardu:

1. Přejděte na Dashboard Postman ↗ > Proměnné.
2. Kopírovat Access Key ID z dashboardu Cloudflare a vložte ji v Postmanu do r2-access-key-id hodnotu proměnné a vyberte Save.
3. Zkopírujte Secret Access Key z dashboardu Cloudflare a vložte ji v Postmanu do r2-secret-access-key hodnotu proměnné a vyberte Save.

Nyní byste již měli mít account-id, r2-secret-access-key, a r2-access-key-id nastavené v Postmanu.

Chcete-li ověřit token:

1. V dashboardu Postman vyberte Cloudflare R2 šipka rozbalovací nabídky složky > Buckets šipka rozbalovací nabídky složky > GETListBuckets.
2. Vyberte Odeslat.

Kolekce Postman k dokončení handshake používá ověření AWS SigV4.

Měli byste vidět 200 OK odpověď se seznamem existujících bucketů. Pokud obdržíte chybu, ujistěte se, že vaše předplatné R2 je aktivní a že jsou proměnné Postman správně uložené.

V dashboardu Postman:

1. Přejděte na Proměnné.
2. Nastavte r2-bucket hodnotu proměnné jako název vašeho bucketu R2 a vyberte Save.
3. Vyberte Cloudflare R2 šipka rozbalovací nabídky složky > Buckets šipka rozbalovací nabídky složky > PUTCreateBucket a vyberte Odeslat.

Měli byste vidět 200 OK odpověď. Pokud spustíte ListBuckets požadavek znovu, váš bucket se zobrazí v seznamu výsledků.

Nyní přidáte objekt do svého bucketu:

1. Přejděte na Proměnné v dashboardu Postman.
2. Nastavte r2-object na cat-pic.jpg a vyberte Save.
3. Vyberte Cloudflare R2 šipka rozbalovací nabídky složky > Objekty šipka rozbalovací nabídky složky > Vícedílné šipka rozbalovací nabídky složky > PUTPutObject a vyberte Odeslat.
4. Přejděte na Body a vyberte binární před připojením vašeho obrázku kočky.
5. Vyberte Odeslat abyste přidali obrázek kočky do svého R2 bucketu.

Po několika sekundách byste měli obdržet 200 OK odpověď.

Stáhnout našeho kočičího kamaráda zabere už jen pár kliknutí pomocí GetObject požadavek.

1. Vyberte Cloudflare R2 šipka rozbalovací nabídky složky > Objekty šipka rozbalovací nabídky složky > GETGetObject.
2. Vyberte Odeslat.

Tým R2 bude tuto kolekci průběžně aktualizovat, jak budeme rozšiřovat sadu funkcí R2. Zbytek kolekce R2 Postman můžete prozkoumat vyzkoušením dalších operací.