مطوري التطبيق

مقدمة

API

كمطور يمكنك إنشاء تطبيقات وإضافتها إلى {SITE_NAME} ، والاستفادة من قاعدة المستخدمين الحالية. استضفت التطبيق ، مما يعني أن كنت في السيطرة الكاملة على مواصفات الخادم الخاص بك.

انشاء تطبيق

للتفاعل مع {SITE_NAME} يمكن التطبيق مسألة تدعو إلى API لدينا وطلب معلومات أو آخر.

عندما تضيف تطبيق لموقعنا سوف نعطيك APP ID.

طلب رمز

كلما كنت تخطط لاستخدام API لدينا يجب عليك أولا طلب رمزية. لطلب رمز تحتاج إلى مفتاح الفريدة التي نرسلها إليك عندما يقوم المستخدم الخاص بك من الزيارات APP iframe على موقعنا. نحن تمرير هذا النحو على طول $_GET['key'].

هذا هو مثال على الطريقة التي يمكن أن تطلب عربون:

http://www.onmymood.com/token.php?key=$_GET['key']

اذا تم بنجاح, سوف تحصل على رد اعجاب JSON:


Object
(
    [token] => LS0tLS1CRUdJTiBQVUJMSUMgS0VZLS0tLS0KTUc4d0RRWUpLb1pJaHZjTkFRRUJCUUFEWGdBd1d3SlVBdHFZdmVWOXFEdDd6NFhXTXYzS3VZM2JyWXpUKzR0VgpBbERrN1dQWjhqRVpoVzBNWjE1Z3lHdGNlNm5ueFRNenp4SXpHM29BRVIzc0JVRCtYdStHb21JeVV4UE1RN1NtCkVPdFg0ZTNwekp6R081cUxBZ01CQUFFPQotLS0tLUVORCBQVUJMSUMgS0VZLS0tLS0K
)

ارسال طلب

الآن أن لديك يمكنك رمزي صالح تقديم الطلبات إلى خادمنا. مع كل طلب يجب أن يمر على هذا الأساس أنشأنا لك.

على وجه المثال الاتصال بـAPI سوف يكون مثل:

http://www.onmymood.com/api.php?token=#{TOKEN}&method=#{METHOD_NAME}

فهم استجابة API

عن الأساليب التي يمكن إرجاع أكثر من عنصر واحد وسوف تتضمن الاستجابة مؤشرا على مجموع العناصر المتاحة ، فضلا عن عدد صفحات هناك. نعود افتراضيا 10 سلعة على الأكثر، وبغية الحصول على 10 سلعة المقبل عملتم لتمرير المعلمة "page=2".

إلى اليسار وسوف تجد قائمة من الوحدات التي تقوم بتطبيق أساليب API. انقر على حدة، وسوف ترى قائمة من الأساليب التي يمكن استخدامها التطبيق الخاص بك. ضيق لأغراض التنسيق ونحن لا تشمل كامل في طلب فقط ولكن هناك أكثر الأجزاء ذات الصلة.

friend

getFriends

GET /api.php?method=friend.getFriends&user_id=#{USER_ID}

يحصل على قائمة كاملة من الأصدقاء لمستخدم معين. إذا كنت لا يجتاز #{USER_ID} وسوف نعود بالمعلومات حول المستخدم الذي تم تسجيل حاليا.

استجابة


Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [user_id] => 7
                    [user_name] => jane-doe
                    [full_name] => Jane Doe
                    [joined] => 1314110027
                    [country_iso] => US
                    [gender] => Female
                    [photo_50px] => http://www.onmymood.com/file/pic/user/7_50.jpg
                    [photo_50px_square] => http://www.onmymood.com/file/pic/user/7_50_square.jpg
                    [photo_120px] => http://www.onmymood.com/file/pic/user/7_120.jpg
                    [photo_original] => http://www.onmymood.com/file/pic/user/7.jpg
                    [profile_url] => http://www.onmymood.com/index.php?do=/jane-doe/
                )

        )

)

isFriend

GET /api.php?method=friend.isFriend&user_id=#{USER_ID}&friend_user_id=#{FRIEND_USER_ID}

2 الشيكات إذا المستخدمين هم اصدقاء أم لا. إذا كنت لا يجتاز #{USER_ID} وسوف نعود بالمعلومات حول المستخدم الذي تم تسجيل دخوله حاليا في.

استجابة


Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [is_friend] => 1
        )

)

mail

getNewCount

GET /api.php?method=mail.getNewCount&user_id=#{USER_ID}

الحصول على العدد الإجمالي للرسائل الغيب. إذا كنت لم تمر #{USER_ID} سوف نعود معلومات عن المستخدم الذي تم تسجيل دخوله حاليا في .

استجابة


Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => 1
)

notification

getNewCount

GET /api.php?method=notification.getNewCount&user_id=#{USER_ID}

الحصول على العدد الكلي للإخطارات الغيب. إذا لم يكن ليمر#{USER_ID} وسوف نعود من المعلومات عن المستخدم الذي سجل دخوله حاليا في.

استجابة


Object
(
    [api] => Object
        (
            [total] => 5
            [pages] => 0
            [current_page] => 0
        )

    [output] => 5
)

get

GET /api.php?method=notification.get&user_id=#{USER_ID}

الحصول على كل من إخطارات المستخدمين. إذا لم يكن ليمر #{USER_ID} وسوف نعود من المعلومات عن المستخدم الذي سجل دخوله حاليا في .

استجابة


Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [notification_id] => 3
                    [link] => http://www.onmymood.com/john-doe/comment-id_1/
                    [message] => Jane Doe commented on your wall
                    [icon] => http://www.onmymood.com/module/blog/static/image/default/default/activity.png
                )

        )

)

photo

addPhoto

POST /api.php?method=photo.addPhoto&photo=#{@FILE_PATH;TYPE=MIME_TYPE}&photo_name=#{BASE_FILE_NAME}

Uploads a photo on behalf of the user.

استجابة


Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [original] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d.jpg
            [75px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_75.jpg
            [100px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_100.jpg
            [150px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_150.jpg
            [240px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_240.jpg
            [500px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_500.jpg
            [1024px] => http://www.onmymood.com/file/pic/photo/2011/08/39740c5e356fdd6f66cfc973d4aebf6d_1024.jpg
        )

)

getPhotos

GET /api.php?method=photo.getPhotos&user_id=#{USER_ID}

الحصول على جميع الصور للمستخدم. إذا لم يكن ليمر #{USER_ID}وسوف نعود من المعلومات عن المستخدم الذي سجل دخوله حاليا.

استجابة


Object
(
    [api] => Object
        (
            [total] => 1
            [pages] => 0
            [current_page] => 0
        )

    [output] => Array
        (
            [0] => Object
                (
                    [photo_100px] => http://www.onmymood.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_100.jpg
                    [photo_240px] => http://www.onmymood.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c_240.jpg
                    [photo_original] => http://www.onmymood.com/file/pic/photo/c81e728d9d4c2f636f067f89cc14862c.jpg
                )

        )

)

user

getUser

GET /api.php?method=user.getUser&user_id=#{USER_ID}

الحصول على معلومات عن المستخدم استنادا إلى هوية المستخدم # لك بالمرور. إذا لم يكن ليمر #{USER_ID} وسوف نعود من المعلومات عن المستخدم الذي سجل دخوله حاليا.

استجابة


Object
(
    [api] => Object
        (
            [total] => 0
            [pages] => 0
            [current_page] => 0
        )

    [output] => Object
        (
            [user_id] => 1
            [user_name] => john-doe
            [joined] => 1314109907
            [gender] => Male
            [country_iso] => US
            [full_name] => John Doe
            [email] => john.doe@site.com
            [photo_50px] => http://www.onmymood.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50.jpg
            [photo_50px_square] => http://www.onmymood.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_50_square.jpg
            [photo_120px] => http://www.onmymood.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e_120.jpg
            [photo_original] => http://www.onmymood.com/file/pic/user/2011/08/9d673759d1cf55c9cd0b0805dc32e68e.jpg
            [profile_url] => http://www.onmymood.com/index.php?do=/john-doe/
        )

)

المطورين

انشاء تطبيق

طلب رمز

ارسال طلب

فهم استجابة API