A licenc létrehozása és az eredeti URL létrehozása külön van választva, így az újrapróbálások biztonságosak, és a friss URL-ek soha nem számítanak fel újra.
1. Hozd létre a licencet
POST /api/v2/licenses
Authorization: Bearer ACCESS_TOKEN
Content-Type: application/json
Idempotency-Key: 2bd25ec7-12da-45fc-9daa-67593b510932
{"media_id":123}Használj egyedi kulcsot 8 és 160 közötti nyomtatható ASCII karakterből a logikai kiválasztási kísérlethez, és tartsd meg újrapróbáláskor is. Az új licenc 201-et ad vissza; az idempotens újrajátszás 200-at ad vissza ugyanazzal a licenc-azonosítóval.
A Cathopic először ellenőrzi az eredetit. Egyetlen tranzakcióban zárolja az egyéni vagy csapat-előfizetést, ellenőrzi a média-hozzáférést és a meglévő megosztott jogosultságokat, legfeljebb egy letöltést fogyaszt, és rögzíti a jogosultságot, az előzményeket és a licencet.
2. Kérd le az eredeti URL-t
POST /api/v2/licenses/LICENSE_UUID/download-url
Authorization: Bearer ACCESS_TOKENAz URL öt perc után lejár. Új letöltéshez kérj új URL-t; ne hozz létre új licencet. A Cathopic a tárolási útvonalat származtatja, és soha nem fogad el tetszőleges útvonalat.
Fontos hibák
subscription_required: nincs aktív, fizetős hozzáférés.media_type_not_in_plan: a típus nincs benne.download_balance_exhausted: nincs több letöltés a korlátozott csomagban.file_unavailable: az eredeti hiányzik; nincs díj.idempotency_key_conflict: a kulcs egy másik médiaazonosítóhoz lett használva.
Tartsd meg a X-Request-Id támogatáshoz, de soha ne naplózz tokeneket, titkokat vagy aláírt URL-eket. 429 vagy átmeneti 5xx válaszok esetén lépj vissza jitterrel.
