Jump to content

Latios

Members
  • Posts

    8
  • Joined

  • Last visited

  • Days Won

    1

Posts posted by Latios

  1. Hi there all!

    I wrote this guide after receiving some questions around how to get a Divine Pride API key in order to use a small CLI tool I made: https://github.com/latiosu/dp2rathena

    This guide aims to present steps required to create a Divine Pride forum account and link it with access to the Divine Pride database service.

    Hopefully it helps!

    ---

    Important Notes

    • If you already have a Divine Pride forum account, go to step 6.
    • API keys are like passwords. Keep them safe and secure. Do not share them with anyone else.

    ---

    Steps

    1. Register a Divine Pride forum account
      1-forum-register.thumb.png.f7dc5f2804957bcf8e6ea36ed8740478.png
       
    2. Confirm your email
      2-confirm-email-forum.thumb.png.685caf2f64f4b41378882cf66cbeeb18.png
       
    3. Go to email inbox and click validation link
      3-confirm-email-inbox.png.ab1559d98d5469fbabbe2c28f3af019d.png
       
    4. Click "Validate my account" on validation page
      4-confirm-button-forum.thumb.jpg.642ea256126ecd3977dc48e4fcebf4fa.jpg
       
    5. Go to Divine Pride database
      5-goto-database.thumb.jpg.fa735c7bce2931d12020ebd31bb967df.jpg
       
    6. Click "Login" on Divine Pride service page
      6-goto-login.thumb.png.d4b22b35e9d40a824056d0b1a90c10c5.png
       
    7. Input Divine Pride forum account credentials
      7-login-form.thumb.png.16a34072761d5e11f22b2dfff4e8dfed.png
       
    8. Input Divine Pride forum account credentials again
      - Tick "New account" if you started from step 1
      - Ignore "New account" if you started from step 6
      8-link-account.thumb.png.f4327caa59714c1fbb5c410aa9d1a6fd.png
       
    9. Go to your Profile in Divine Pride database service
      9-goto-profile.thumb.jpg.f2901123aca97f9ccd4dfdf87ab65460.jpg
       
    10. Click "Request" under Api Key section
      10-request-api-key.thumb.jpg.1d5c7cc15668b22267e97a6d8e35199f.jpg
       
    11. Congratulations! 🎉 You now have your very own Divine Pride API key! 🎊
      Remember to keep your API key safe and secure. API keys are like passwords.
      Please avoid sharing your API key.
      11-done.thumb.png.b2bcb0ebd97684261412d506407ef36a.png

    ---

    Now go out there and make cool stuff! 🎉

    • Thanks 1
    • mvp 1
  2. Hi there,

    I'm currently working on a tool which consumes the DP API but am missing access to the skill aegis name. 
    It appears to be available in the Skill database, for example with ID 2540: https://www.divine-pride.net/database/skill/2540/unchained-serenade

    image.png.08a94e9eb4670cc85f8fa517aeee4e41.png

    Currently the API returns this for skill ID 2540:

    {
        "id": 2540,
        "name": "Unchained Serenade",
        "description": ""
    }

    Would be amazing if it could "NPC_DISSONANCE" in an additional field such as:

    {
        "id": 2540,
        "name": "Unchained Serenade",
        "aegis_name": "NPC_DISSONANCE",
        "description": ""
    }

    Is it possible to have the below field exposed in the Skill API?

  3. I think I've been able to confirm some mappings for the following values. Although I haven't been able to reverse engineer or map "classNum" yet.

    Would be awesome to have someone officially confirm if these are the intended values too.

    locationId
    An integer bitmask from 0 to 0x3FFFFF with value returned as decimal.
    Example: 768 (0x300) = Head Top + Head Mid

    Spoiler

    0x000001: Head Low
    0x000002: Right Hand
    0x000004: Garment
    0x000008: Right Accessory
    0x000010: Armor
    0x000020: Left Hand
    0x000022: Both Hand
    0x000040: Shoes
    0x000080: Left Accessory
    0x000088: Both Accessory
    0x000100: Head Top
    0x000200: Head Mid
    0x000400: Costume Head Top
    0x000800: Costume Head Mid
    0x001000: Costume Head Low
    0x002000: Costume Garment
    0x010000: Shadow Armor
    0x020000: Shadow Weapon
    0x040000: Shadow Shield
    0x080000: Shadow Shoes
    0x100000: Shadow Right Accessory
    0x200000: Shadow Left Accessory


    job
    An integer bitmask from 0 to 0xFFFFF (with value returned as decimal) for 1st and 2nd jobs or an integer from 73 to 503 for extended and 3rd jobs.
    Note: I could not find all values, some clearly missing values have been marked with a '?'.
    Example: 132112 (0x20410) = Acolyte + Priest + Monk

    Spoiler

    0x00001: Novice
    0x00002: Swordman
    0x00004: Mage
    0x00008: Archer
    0x00010: Acolyte
    0x00020: Merchant
    0x00040: Thief
    0x00080: Knight
    0x00100: Wizard
    0x00200: Hunter
    0x00400: Priest
    0x00800: Blacksmith
    0x01000: Assassin
    0x02000: Crusader
    0x04000: Sage
    0x08000: Bard
    0x10000: Dancer
    0x20000: Monk
    0x40000: Alchemist
    0x80000: Rogue
    0xFFFFF: All
    73: Gunslinger
    74: Ninja
    81: Mechanic and Genetic
    82: Guillotine Cross and Shadow Chaser
    83: Warlock and Sorceror
    95: Lord Knight
    97: Whitesmith
    99: High Wizard
    105: High Priest
    106: Champion
    107: Stalker
    111: Rune Knight
    112: Royal Guard
    114: Guillotine Cross
    115: Mechanic
    116: Ranger
    117: Genetic
    118: Warlock
    119: Sorceror
    120: Minstrel
    121: Wanderer
    122: Arch Bishop
    123: Sura
    124: Shadow Chaser
    141: Soul Linker
    142: Summoner
    143: Taekwon
    144: Kagerou/Oboro and Rebellion
    145: Star Emperor
    146: Soul Reaper
    500: Rebellion
    501: Kagerou/Oboro
    502: Super Novice
    503: Star Gladiator
    ?: Assassin Cross
    ?: Biochemist
    ?: Clown
    ?: Gypsy
    ?: Paladin
    ?: Professor
    ?: Sniper


    itemTypeId
    An integer value from 1 to 10 (excluding 8).
    Example: 5 = Etc

    Spoiler

    1: Weapon
    2: Armor
    3: Consumable
    4: Ammo
    5: Etc
    6: Card
    7: Cash
    9: Costume
    10: Shadow Gear


    itemSubTypeId
    An integer value from 0 to 1027 (excluding ranges 1-255, 281-511, 520-521, 523-524, 531-767, 770-1023).
    Example: 280 = Shadow Weapon

    Spoiler

    0: None
    256: Dagger
    257: One-handed Sword
    258: Two-handed Sword
    259: One-handed Spear
    260: Two-handed Spear
    261: One-handed Axe
    262: Two-handed Axe
    263: One-handed Mace
    264: Two-handed Mace
    265: One-handed Staff
    266: Two-handed Staff
    267: Bow
    268: Knuckle
    269: Musical
    270: Whip
    271: Book
    272: Katar
    273: Revolver
    274: Rifle
    275: Gatling
    276: Shotgun
    277: Grenade
    278: Huuma
    280: Shadow Weapon
    512: Helm
    513: Armor
    514: Shield
    515: Garment
    516: Shoes
    517: Accessory
    518: Pet
    519: Costume Helm
    522: Costume Garment
    525: Costume Floor
    526: Shadow Armor
    527: Shadow Shield
    528: Shadow Shoes
    529: Shadow Right Accessory
    530: Shadow Left Accessory
    768: Special
    769: Regeneration
    1024: Arrow
    1025: Cannon Ball
    1026: Throw Weapon
    1027: Bullet

     

  4. Hi Divine-Pride team,

    I thought it would be helpful for developers to have some additional documentation about the API to make it easier to get up and running with.
    There are a few values in the Item API which require some work to make sense of:

    For example, the following values are returned for Sword (1101) are ambiguous without investigation:

    "classNum": 2,
    "itemTypeId": 1,
    "itemSubTypeId": 257,

    I think it would be very helpful for developers to know how to make sense of the above values.

    Developers can take the time to manually map out each variation, for example itemTypeId 1 seems to represent "Weapon" and itemSubTypeId 257 seems to represent "Sword".
    A list of these mappings would be very helpful on either the forum or API documentation itself: https://www.divine-pride.net/api
     

    Kind regards,
    Latios

×
×
  • Create New...