API-hozzáférés, hatókörök és fejlesztői engedélyek házirendje
Hogyan biztosít az X2 moduláris API-hozzáférést szolgáltatás, cél és engedély alapján.
1. Alapelv
Az X2 cél, szolgáltatás és engedély alapján biztosít hozzáférést a technológiához, nem pedig az X2 platformhoz való korlátlan hozzáféréssel.
2. Szolgáltatás alapú hozzáférés
A támogatott API-domainek közé tartozhatnak a katalógus, a jogok és közzététel, a terjesztés, az elemzések, a közönség, a közösségi és felhasználói tartalmak bevételszerzése, a jogdíjak és jelentések, az AI-ellenőrzés, a szakmai ellenőrzés és más engedélyezett szolgáltatások. Az egyik domainhez való hozzáférés nem jelent egy másik tartományt.
3. Hatókör alapú engedélyezés
A hitelesítő adatok olvasási, írási vagy érzékeny műveletekre korlátozódhatnak, mint például a catalog.read, catalog.write, Rights.read, Rights.claims.submit, distribution.submit, analytics.read, royalties.read vagy ai.verify. A végleges műszaki hatókör neveket az API specifikáció határozza meg.
4. Felhasználói, munkaterületi és szervezeti jogosultság
Az alkalmazások csak a jogosult felhasználóhoz, szervezethez vagy más entitáshoz tartozó erőforrásokhoz férhetnek hozzá, amelyekhez kifejezetten engedélyt adtak. Az ügyfelek közötti korlátlan hozzáférés nem része a szokásos API-engedélyezésnek.
5. Pályázat regisztráció
Az X2 a hozzáférés megadása előtt megkövetelheti a fejlesztői vagy vállalati azonosítót, az alkalmazás nevét, a tervezett célt, az átirányítási URL-eket, a kért hatóköröket, a várható forgalmat, a biztonsági információkat, az adatmegőrzési gyakorlatokat és a kapcsolattartási adatokat.
6. Jóváhagyási szintek
Az X2 megkülönböztetheti a szabványos, ellenőrzött fejlesztői, korlátozott és vállalati vagy partner hozzáférést kockázat, funkció és szerződéses követelmények alapján.
7. Érzékeny körök
A jogok átruházása, a tulajdonjog megváltoztatása, a kedvezményezett módosítása, a kifizetési utasítások, a KYC- vagy a személyazonossági adatok, a végrehajtási intézkedések, a tömeges követelések és más kényes funkciók kézi jóváhagyást, szigorúbb ellenőrzést vagy külön megállapodást igényelhetnek.
8. Pénzügyi engedélyek
A jogdíjjelentések olvasásának engedélye nem engedélyezi automatikusan a kedvezményezett módosítását, a bankszámla módosítását vagy a kifizetés kezdeményezését.
9. Jogok Engedélyek
A jogokkal kapcsolatos adatok olvasásának engedélye nem engedélyezi automatikusan a jogok átruházását, követeléseit vagy tulajdonosi változásait.
10. OAuth hozzájárulás
A felhasználók nevében eljáró alkalmazásoknak kifejezett hatóköröket kell kérniük, és egyértelműen be kell mutatniuk ezeket az engedélyeket. A felhasználóknak képesnek kell lenniük a jövőbeni hozzáférés visszavonására.
11. Nincs univerzális API-kulcs
Az X2 nem használ olyan univerzális hitelesítő adatokat, amelyek automatikusan hozzáférést biztosítanak minden szolgáltatáshoz. A hitelesítő adatokat társítani kell egy tulajdonoshoz, alkalmazáshoz, hatókörhöz, környezethez, korlátokhoz és állapothoz.
12. Ellenőrzési nyomvonal
Az érzékeny API-műveletek naplózhatók szereplővel, alkalmazással, hatókörrel, erőforrással, művelettel, idővel és eredménnyel.
13. Homokozó és gyártás
A homokozó és a termelési hozzáférés külön van. A gyártáshoz való hozzáférés további ellenőrzést és jóváhagyást igényelhet.
14. Belső szolgáltatások közötti hozzáférés
Ugyanez a legkisebb jogosultság elve vonatkozik a belső X2 szolgáltatásokra is. Egy szolgáltatásnak csak a működéséhez szükséges API-engedélyeket kell megkapnia, nem pedig korlátlan adatbázis-hozzáférést.
15. Szolgáltatói adapterek
A külső DSP-k, pénzügyi szolgáltatók, jogvédő szervezetek és egyéb adapterek csak az adott integrációhoz szükséges adathozzáférést kapják meg.
16. Adatexportálás
A felhatalmazott felhasználók exportálhatnak jogosult katalógust, metaadatokat, jogokat, jelentéseket, regisztrációkat vagy egyéb támogatott információkat anélkül, hogy megkapnák a nem kapcsolódó ügyféladatokat, védett belső adatkészleteket, biztonsági információkat vagy csalási modelleket.
17. Díjak és felfüggesztés
Az API-hozzáférés lehet ingyenes, szolgáltatás- vagy felhasználásalapú. Az X2 felfüggeszthet egy visszaélésszerű hitelesítő adatot vagy alkalmazást anélkül, hogy szükségszerűen felfüggesztené a teljes ügyfélfiókot.